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About This Manual 


Who should use this manual... 


This guide is intended for the System/36 programmer responsible for defining or 
using the System/36 for communications. 

Using this manual, the System/36 programmer will be able to: 

• Change the system communications values (SETCOMM) 

• Change display station communications values (ALTERCOM) 

• Define an SNA (systems network architecture) X.25 or SDLC (synchronous 
data link control) line member configuration 

• Define a BSC line member configuration 

• Define an asynchronous communications subsystem member configuration 

• Define an X.25 configuration 

— Define an X.25 network and logical channel configuration 
— Define an X.25 virtual circuit configuration 

• Get the status of an X.25 virtual circuit 

• Change active X.25 virtual circuit values 

• Define an APPC (advanced program-to-program communications) subsystem 
for DDM (Distributed Data Management), PS/36 (Personal Services/36), 

C & SM (Communications and Systems Management) alerts, or Display 
Station Pass-Through 

• Define asynchronous and asynchronous/X.25 line member configurations 


About This Manual XI 



How this manual is airai^ed... 


• Chapter 1 introduces the topics covered in this manual and provides an 
overview of the System/36 communications support. 

• Chapter 2 describes how the SETCOMM and ALTERCOM procedure 
commands can be used to define the communications environment. 

• Chapter 3 describes using the CNFIGICF procedure to define line member 
configurations for BSC, SNA/SDLC, and SNA/X.25 communications. 

• Chapter 4 describes using the CNFIGX25 and MAINTX25 procedures to 
define and maintain a configuration for an X.25 packet-switching network. 

• Chapter 5 describes defining lists for autocall, BSCEL, X.25, and X-21. 

1 

• Chapter 6 describes using the ENABLE and DISABLE procedure commands 
to start and stop communications subsystems. 

• Chapter 7 discusses problem determination and link verification procedures for 
communications. 

• Chapter 8 discusses requesting an X.21 network facility. 

• Chapter 9 describes configuring an APPC subsystem for use by DDM, C & SM 
alert support. Display Station Pass-Through, and Personal Services (PS/36). 

• Chapter 10 describes APPC session groups. 

• Chapter 11 describes the asynchronous communications support. 

• Chapter 12 describes file transfer subroutines. 

• Appendix A shows a chart of the X.25 network types by country. 

• Appendix B discusses CICS/VS and System/38 considerations. 

• Appendix C describes APPC security. 

• Appendix D contains the syntax diagrams for the procedures discussed in this 
book. 

• Appendix E describes the connection values for subsystem configurations on 
switched lines. 

• Appendix F contains the LU6.2 verbs. 

• Appendix G contains information about Display Station Pass-Through. 

• Appendix H contains information about X.21 short hold mode. 

• The Glossary defines the data processing, data communications, and 
System/36 terms used in this manual. 
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What you should know... 


The reader is assumed to have read the following manual or have the equivalent 
knowledge: 

• IBM System/36 Learning About Your Computer, SC21-9018 

If you need more information . •. 

The IBM publications listed here provide additional information about topics 
described or referred to in this guide. 

System/36 Publications 

• Operating Your Computer (5360 and 5364), SC21-9026 

• Operating Your Computer (5364), SC21-9085 

• System Problem Determination, SC21-7919 for the 5360 System Unit, or 
SC21-9063 for the 5362 System Unit 

• System Reference, SC21-9020 

• Multiple Session Remote Job Entry Guide, SC21-7909 

• Multiple Session Remote Job Entry Messages, SC21-7944 

• 3270 Device Emulation Guide, SC21-7912 

• 3270 Device Emulation Messages, SC21-7945 

• Interactive Communications Feature: Reference, SC21-7910 

• Interactive Communications Feature: Guide and Examples, SC21-7911 

• Communications and Systems Management Guide, SC21-8010 

• Concepts and Programmer’s Guide, SC21-9019 

• System Security Guide, SC21-9042 

• Performing the First System Configuration for Your System (5360), SC21-9022 

• Performing the First System Configuration for Your System (5362), SC21-9067 

• Performing the First System Configuration for Your System (5364), SC21-9115 

• Changing Your System Configuration, SC21-9052 

• Converting from System/34 to System/36, SC21-9053 

• Distributed Data Management Guide, SC21-8011 
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• Source Entry Utility Guide, SC21-7901 

• Programming with RPG 11, SC21-9006 

• Programming with Assembler, SC21-7908 

• Planning for Data Communications, SA21-9441 (Workbook 4 of What to Do 
Before Your Computer Arrives (5360), SBOF-4773 

• Planning for Data Communications, SA21-9482 (Workbook 4 of What to Do 
Before Your Computer Arrives (5362), SBOF-4778 

• Preparing for Data Communications (5364), SC21-9844 

• Using the Asynchronous Communication Support, SC21-9143 

General Communications 


• Data Communications Concepts, GC21-5169 


Data Link Control 

• IBM Synchronous Data Link Control General Information, GA27-3093 

• General Information—Binary Synchronous Communications, GA27-3004 

Systems Network Architecture (SNA) 

• Systems Network Architecture Reference Summary, GA27-3136 

• Systems Network Architecture 3650 RSS Administrator's and Operator's Guide, 
GA27-3134 

• Systems Network Architecture Concepts and Products, GC30-3072 

• Systems Network Architecture Format and Protocol Reference Manual: 
Architectural Logic, SC30-3112 

• Systems Network Architecture Format and Protocol Reference Manual: 
Architectural Logic for LU Type 6.2, SC30-3269 

• Systems Network Architecture Technical Overview, SC30-3073 

• Systems Network Architecture—Sessions Between Logical Units, GC20-1868 

• Systems Network Architecture Transaction Programmer's Reference Manual for 
SNA LU6.2, GC30-3084 
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Commiimcations ControUers 


• IBM 3704 and 3705 Program Reference Handbook^ GY30-3012 

• Guide to Using the IBM 3 704 Communications Controller Control Panel, 
GA27-3086 

• Guide to Using the IBM 3 705 Communications Controller Control Panel, 
GA27-3087 

• IBM 3 704 and 3 705 Control Program Generation and Utilities Guide and 
Reference Manual, GC30-3008 

• Introduction to the IBM 3 704 and 3 705 Communications Controllers, 
GA27-3051 

• 3725 Model 1 Communication Controller, Introduction, GA33-0010 

• 3725 Model 2 Communication Controller, Introduction, GA33-0021 

• 3725 Communication Controller, Principles of Operation, GA33-0013 

• The X.25 Interface for Attaching IBM SNA Nodes to Packet-Switched Data 
Networks—General Information Manual, GA27-3345 

• IBM Implementation of X.21 Interface General Information, GA27-3287 

VTAM 

• Advanced Communications Function for VTAM (ACF/VTAM) General 
Information, GC38-0254 

• VTAM Systems Programmer's Guide, SC38-0258 


I How this manual has changed ... 


I 


The following are the major changes made to this manual since the previous 
edition: 

• More information has been added to Chapter 4 about using DEFINX21 for 
X.21 short hold mode. 

• Information about configuring asynchronous line members has been added to 
Chapter 11. 

• Information about file transfer subroutines (FTS) has been added to Chapter 

12 . 

• Information about Display Station Pass-Through has been added to Appendix 
G. 

• Information about X.21 short hold mode has been added to Appendix H. 
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Chapter 1. Introduction 


System/36 supports a wide range of communications types. This support is 
packaged as follows: 

• Base SSP: 

— Remote work station support (RWS) 

Note: Remote work station support is defined during system configuration. 
See the manual Performing the First System Configuration for Your 
System or the manual Changing Your System Configuration for the 
information needed to configure System/36 for RWS. Once the 
communications link is established with a remote work station, that 
work station operates the same as a local work station. In certain 
instances, a line used for R WS can also be used by an SSP-ICF 
subsystem, 

- Batch binary synchronous communications (batch BSC) 

Note: For instructions on defining a communications line that will be used 
by batch BSC, see the SETCOMM and ALTERCOMprocedure 
commands. For information on programming for batch BSC, see the 
language manual (Programming with Assembler for assembler and 
Programming with RPG H for RPG II.) 

• Communications feature: 

— MLCA support 

— ELCA support 

— X.21 switched support 

— X,25 support 

— Autocall support 

— Base support for all communications features 

— Advanced program-to-program-communications (APPC) basic 
conversation support 

1 — Asynchronous communications support 
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• Separately priced features; 

— Interactive Communications Feature (SSP-ICF) 

Binary Synchronous Communications Equivalence Link (BSCEL) 
subsystem 

BSC CICS subsystem 

BSC IMS/IRSS subsystem 

SNA Upline Facility (SNUF) subsystem 

SNA Peer subsystem 

SNA Finance subsystem 

SNA APPC subsystem (mapped conversation support) 

BSC CCP subsystem 
INTRA subsystem 

- 3270 Device Emulation 

— Multiple Session Remote Job Entry (MSRJE) 

- Distributed Disk File Facility PRPQ (DDFF) 

- Communications and Systems Management (C & SM) 

— Distributed Data Management (DDM) 

— Display Station Pass-Through 
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Much of the information needed to use the different types of communications is 
common to more than one type of communications. Within this manual is 
information needed to: 


• Define an SNA line member; this information is needed by users of SNA 
MSRJE, DDM, C & SM, SNA 3270, and the SSP-ICF SNA subsystems. 

• Configure a BSC subsystem used by BSC MSRJE, BSC 3270, and the 
SSP-ICF BSC subsystem. 

• Configure an APPC subsystem required by PS/36 (for document distribution), 
C & SM alerts. Display Station Pass-Through, and DDM. 

• Call the file transfer subroutines used by asynchronous communications, 
APPC, BSCEL, and Peer subsystems. 

In addition, many of the procedures, such as ENABLE and DISABLE, are used by 
all subsystem users. 
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Chapter 2. Setting and Changing System Values 


SETCOMM Procedure 

You use the SETCOMM procedure to set certain communications items in the 
communications configuration record. You can use the STATUS COMCNFIG (D 
H) control command to display the current settings. 

The changes you make using the SETCOMM procedure remain in effect until 
changed by a subsequent SETCOMM procedure. 

You may need to use the SETCOMM procedure command to change one or more 
of the communications values that were set by IBM when your system was 
manufactured. For example, when you ordered the system, you may have specified 
a switched communications line. During the planning process, you determined that 
you actually need a nonswitched line. Since the order specified switched, that is 
how the machine is defined. So, you simply use the SETCOMM procedure 
command to change the definition for the appropriate communications line. 

Refer to the manual Planning for Data Communications: Workbook 4 (of What to 
Do Before Your Computer Arrives) for information on the items that may need to be 
changed. 

After you run the SETCOMM procedure, you must IPL the system to make the 
changes effective. See the manual Operating Your Computer for information about 
how to IPL. If you used the ALTERCOM procedure to change any values for a 
display station, those changes are lost when you IPL and the values specified in the 
SETCOMM procedure become effective. After the IPL, use the STATUS 
COMCNFIG command to ensure that the changes are correct. 

The SlETCOMM procedure runs the $SETCP utility program. 
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Following is a copy of the SETCOMM procedure prompt display and an 
explanation of the parameters: 


SETCOMM PROCEDURE 

Sets the communications configuration parameters 

Line number.1-8 

Line type . SHM,MULTCONT,MULTTRIB,NONSWTCH,SWITCHED 

Use system clocking facility . CLOCK,NOCLOCK 

NRZI data encoding . NRZI,NONRZI 

Use continuous carrier feature . CONCAR,NOCONCAR 

Use non-U.S. answer tone . TONE,NOTONE 

Use autocall separator characters.SEP,NOSEP 

Use autocall end-of-number characters.EON,NOEON 

Primary SDLC time-out value . .05-80 

Number of primary SDLC error retries . 1-5 

Modem . IBMLPDA,IBM387X,NONIBM 

X.25 support. X25,NOX25 

DDSA line speed . 2400BPS,4800BPS,9600BPS,56KBPS 


Optional-* 


Cmd3-Previous menu 



COPR IBM Corp. 1986^ 


Although each parameter is optional, at least one parameter must be specified. If a 
parameter is not specified, its current value is not changed. 

Line number specifies the number of the communications line for which the settings 
are to be changed. If no parameter is specified, 1 is assumed. 

Line type specifies the type of communications line to be used. Allowed entries for 
this field are: 

SHM specifies that the line uses X.21 short hold mode, which helps reduce line 
usage by disconnecting the circuit switched line when there is no line activity. 

MULTCONT specifies that the System/36 is the control station on a 
multipoint line. This parameter cannot be used with BSC. 

MULTTRIB specifies that the System/36 is a tributary station on a multipoint 
line. 

NONSWTCH specifies that the line is a nonswitched line. Also, specify 
NONSWTCH if an X.25 network is used. 

SWITCHED specifies that the line is a point-to-point switched line. 
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Use system clocking facility specifies whether internal or external clocking is done 
for communications. Allowed entries are: 

CLOCK specifies that the system must provide business machine clocking for 
data communications. 

NOCLOCK specifies that the modem or another external source supplies the 
clocking facility. 

Note: If the internal clock is already assigned to a line, this parameter will not 
disable it. 

NRZI data encoding specifies the type of data encoding to be used for the line. 
Allowed entries are: 

NRZI specifies that NRZI (non-return-to-zero-inverted) data encoding is to be 
used with SDLC protocol for modems that are sensitive to certain bit patterns 
in the data stream. On the System/36, this is a method of transmitting data in 
which the signal is changed to transmit a 0 bit. For the 1 bit, the signal stays 
the same; this ensures that the signal does not stay the same for an extended 
period of time. NRZI can only be used if the System/36 modem, the remote 
system modem, and the remote system or device are also using NRZI. 

NONRZI specifies that the line will not use NRZI. 

Use continuous carrier feature specifies whether the continuous carrier feature is to 
be used. Allowed entries are: 

CONCAR specifies continuous carrier. This is a feature that holds the 
’request-to-send’ signal active. Specify CONCAR when modems or modem 
eliminators are used and the multipoint control station is on a four-wire 
nonswitched communications facility, or when the interface is a four-wire 
nonswitched point-to-point communications facility and the modem does not 
support switched network backup. Also, specify CONCAR if an X.25 network 
is used. 

NOCONCAR specifies that the continuous carrier feature will not be used. 
Specify NOCONCAR for a multipoiijit tributary station, for two-wire 
point-to-point networks, for a switched public telephone line, or for an 
interface that uses a Digital Data Service Adapter (DDSA) or uses an X.21 
interface adapter on a switched network. 

Use non-U.S. answer tone specifies whether a non-U.S. answer tone is required. 
Allowed entries are: 

TONE specifies that a non-United States answer tone is required for manual 
answer and autoanswer communications. This setting is modem-dependent. 

NOTONE specifies that a non-United States answer tone is not required. 
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Use autocall separator characters specifies whether your autocall unit supports 
separator characters. Allowed entries are: 

SEP specifies that your autocall unit supports separator characters. When the 
system attempts to dial a phone number containing a separator character, the 
character is sent to the autocall unit to do the separation delay. 

See the “DEFINEPN Display Description” in Chapter 5 for a description of 
the use of separator characters. 

NOSEP specifies that your autocall unit does not support separator characters. 
When the system attempts to dial a phone number containing a separator 
character, the character is not sent to the autocall unit. Instead, the system 
does a 3-second separation delay. 

Use autocall end-of>number characters specifies whether your autocall unit has 
answer tone detection. Allowed entries are; 

EON specifies that your autocall unit does not have answer tone detection 
capability. If your autocall unit does not have answer tone detection capability, 
you should use an end-of-number character in the phone numbers you specify 
with the DEFINEPN procedure. The end-of-number character will be sent 
from the system to the autocall unit. 

See the “DEFINEPN Display Description” in Chapter 5 for a description of 
the use of end-of-number characters. 

NOEON specifies that your autocall unit has answer tone detection capability. 
If you use an end-of-number character in the phone numbers you specify with 
the DEFINEPN procedure, the character will not be sent from the system to 
the autocall unit. 

Primary SDLC time-out value specifies the SDLC time-out value. You can enter 
any number from 05 through 80, where the first digit indicates the seconds and 
the second digit represents the tenths of seconds and must be 0 or 5. For 
example, 25 specifies 2.5 seconds. 

Number of primary SDLC error retries specifies the number of primary SDLC error 
retries to be attempted when an error occurs. You can enter any value from 1 
through 5. That value multiplied by 7 is the number of retries that will be 
attempted. 
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Modem specifies if an IBM external modem or non-IBM modem is used. Allowed 
entries are: 

IBMLPDA specifies that an IBM modem with Link Problem Determination 
Aid (LPDA) function is being used on the communications line. This includes 
IBM modems such as the 3863, 3864, 3865, 3833, and 3834. 

IBM387X specifies that an IBM 3872, 3874, or 3875 external modem is being 
used on the communications line. 

NONIBM specifies that a non-IBM modem is being used. 

X.25 support specifies whether the line is to be dedicated for X.25 usage. 

X25 specifies that the line uses X.25 support. 

NOX25 specifies that the line does not use X.25 support. 

DDSA line speed allowed entries are: 

2400BPS specifies a DDSA (Digital Data Service Adapter) line with a line 
speed of 2400 bps. 

4800BPS specifies a DDSA line with a line speed of 4800 bps. 

9600BPS specifies a DDSA line with a line speed of 9600 bps. 

5 6KB PS specifies a DDSA line with a line speed of 56 000 bps. 


Example 


This example (using the SETCOMM procedure command) shows how to set 
communications line 1 to be nonswitched point-to-point. 

SETCOMM ,NONSWTCH 

See Appendix D for the format of the SETCOMM procedure command. 
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ALTERCOM Procedure 


You use the ALTERCOM procedure to change communications items for a 
specified communications line. Changes only apply to programs run from the same 
display station as the ALTERCOM procedure. To change items so that all the 
display stations are affected, see the “SETCOMM Procedure.” 

You can use the STATUS COMM (D C) command to display the current status of 
some of the communications items that you can change with the ALTERCOM 
procedure. 

For the Interactive Communications Feature (SSP-ICF) BSC subsystems, for BSC 
MSRJE, and for BSC 3270 device emulation, you can change: 

• The communications line type 

• The modem speed (either full or half speed) 

• Whether a secondary backup line is to be used 

For SSP-ICF SNA subsystems, remote work stations, SNA MSRJE, and SNA 3270 
device emulation, you can change: 

• The communications line type 

• The modem speed (either full or half speed) 

• Whether a secondary backup line is to be used 

• The SDLC time-out value 

• The SDLC retry count 
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For batch BSC data communications, you can change: 

• The communications line type 

• The switch type 

• The remote switched line ID 

• The local switched line ID 

• The tributary address 

• Whether blanks are to be compressed or truncated 

• The wait time before an error condition is assumed 

• Whether 3740 multiple file mode is to be used 

• The record separator 

• The modem speed (either full or half speed) 

• Whether a secondary backup line is to be used 

• The error retry count 

If you do not specify a parameter, its current value is not changed. 

The ALTERCOM procedure can be run from any display station. 

If a communications subsystem is to be enabled and the ALTERCOM procedure is 
required, you must run the ALTERCOM procedure from the same display station 
as the ENABLE procedure. If you run ALTERCOM while a subsystem is enabled, 
the subsystem must be disabled and enabled again before the new values will be 
used. 

Changes made by ALTERCOM remain in effect until: 

• The items are changed again by the ALTERCOM procedure or the $SETCF 
utility program. 

• The system is configured again. 

• An IPL from diskette restores the system library. 

• An IPL after the SETCOMM procedure was run. 

See the manual Interactive Communications Feature: Guide and Examples for more 
information about SSP-ICF data communications. See the manual MSRJE Guide 
for more information about MSRJE. See the manual 32 70 Device Emulation Guide 
for more information about 3270 device emulation. See the manual Programming 
with RPG II and the manual Programming with Assembler for information about 
batch BSC data communications. 

The ALTERCOM procedure runs the $SETCF utility program. 
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Following is a copy of the ALTERCOM procedure prompt display and an 
explanation of the parameters: 


ALTERCOM PROCEDURE Optional-* 

Updates communications line, batch BSC, or SDLC parameters 


Line number.1-8 

Line type . SHM,MULTCONT,MULTTRIB,NONSWTCH,SWITCHED 

Switch type.AA,MA,MC 

Hexadecimal equivalent of remote switched line ID . 

Hexadecimal equivalent of local switched line ID . . 

Hexadecimal equivalent of one of tributary 

station addressing characters . 

Blank compression or truncation.NONE,COMPRESS,TRUNCATE 

BSC wait time in seconds. 1-999,R 

Transmit or receive 

multiple 3740-type files . NONMULT,MULTFILE 

Record separator . 

Modem speed . FULL,HALF 

Use a switched network backup line . NOSNBU,SNBU 

Number of batch BSC error retries . 1-255,R 

Primary SDLC time-out value . 05-80 

Number of primary SDLC error retries . 1-5 


1 


Cmd3-Previous menu 


COPR IBM Corp. 1986 


Although each parameter is optional, at least one parameter must be specified. If a 
parameter is not specified, its current value is not changed. 

Line number specifies the number of the communications line that is to have one or 
more of its characteristics changed. The default is line 1. 

Line type specifies the type of communications line to be used. Allowed entries 
are: 


SHM specifies that the line uses X.21 short hold mode, which helps reduce line 
usage by disconnecting the circuit-switched line when there is no line activity. 


Aft/LTCOAT specifies that the System/36 is the control station on a 
multipoint line. This parameter cannot be used with BSC. 

MULTTRIB specifies that the System/36 is a tributary station on a multipoint 
lind. 


NOiNSWTCH specifies that the line is a nonswitched line. 
SWITCHED specifies that the line is a point-to-point switched line. 
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Switch type specifies the type of switched line used. Allowed entries are: 

AA specifies that if the modem is in automatic answer mode, the system is to 

automatically answer the call. 

MA specifies that the system operator is to manually answer the call. 

MC specifies that the system operator is to manually place the call to the 

remote device. 

Note: For autocall, specify AA, You must also specify the phone list to be used 
in the subsystem's configuration. 

Hexadecimal equivalent of remote switched line ID specifies the hexadecimal value 
of the remote station ID. Two, four, six, or eight hexadecimal digits can be 
specified. If the ID of the remote station is longer than eight hexadecimal digits, 
the ID must be specified in the program. If you specify an R, the remote ID is 
reset to hex 0. 

Hexadecimal equivalent of local switched line ID specifies the hexadecimal value of 
the local station ID. Two, four, six, or eight hexadecimal digits can be specified. 
If the ID of the local station is longer than eight hexadecimal digits, the ID must 
be specified in the program. If you specify an R, the local ID is reset to hex 00. 

Hexadecimal equivalent of one of tributary station addressing characters specifies the 
address of the system on the multipoint communications line. The tributary 
address is the hexadecimal value of one of the pair of tributary station 
addressing characters. For example, to indicate the EBCDIC addressing 
characters SS, the value E2 would be entered (E2 is the hexadecimal equivalent 
of the EBCDIC letter S). If no address is specified, the value in the program is 
used. If you specify an R, the tributary address is reset to hex 00. 

See “Tributary Station Addressing and Polling Characters” in this chapter for 
the tributary addressing and polling characters. 

Blank compression or truncation specifies compression and truncation values. 
Allowed entries are: 

NONE specifies that neither blank compression nor truncation is to be 

performed. 

COMPRESS specifies that embedded blanks are to be compressed. 

TRUNCATE specifies that trailing blanks are to be truncated (that is, cut off). 

BSC wait time in seconds specifies the number of seconds that BSC is to wait for 
the System/36 user program to issue a BSC request before it indicates that an 
error has occurred. You can specify any decimal number from 1 through 999. If 
you specify R, the BSC wait time is reset to 0. 
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Transmit or receive multiple 3740-type files specifies whether more than one 
3740-type file can be used. Allowed entries are: 

NONMULT specifies that multiple files cannot be transmitted or received. 

MULTFILE specifies that more than one (3740-type) file can be transmitted 
or received. 

Record separator specifies the record separator. See the manual Programming with 
RPG H or the manual Programming with Assembler for niore information about 
record separator characters. If you specify R, the record separator is reset to 
hex 00. The default is hex IE. 

Modem speed specifies the speed used by the modem. Allowed entries are: 

FULL specifies that the full rated speed of the modem is to be used. 

HALF specifies that half of the full rated speed of the modem is to be used. 
This is only valid if the modem supports half rate. 

Use a switched network backup line specifies whether a switched network backup 
line is used. Allowed entries are: 

NOSNBU specifies that no switched network backup line is to be used. 

SNBU specifies that the switched network backup line is to be used if a failure 
occurs on the nonswitched primary line. 

This is only valid if the modem and the remote system support switched 
network backup. 

If SNBU is specified for BSC, and manual call, manual answer, or automatic 
answer is not specified, the connection either becomes manual call or manual 
answer depending on the first communications line operation done by the 
program. If the first line operation is a transmit operation, manual call is 
assumed. If the first line operation is a receive operation, manual answer is 
assumed. 

Number of batch BSC error retries specifies the number of times a transmission is 
to be attempted if an error occurs. You can specify any decimal number from 1 
through 255. 

If you specify 255, you are indicating that there is no limit on the number of 
retries to be attempted when waiting for data from the remote system. 

If you specify an R, the BSC retry count is reset to hex 00. 

Primary SDLC tune-out value specifies the SDLC time-out value. You can specify 
a number from 05 through 80, where the first digit indicates the seconds and the 
second digit represents tenths of seconds and must be 0 or 5. 
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Number of primary SDLC error retries specifies the number of retries of a 

transmission that are to be attempted when an error occurs. You can specify a 
number from 1 through 5. The number indicates the multiple of seven retries 
that are attempted; for example, 2 means 14 retries. 

Examples 1 and 2 use the ALTERCOM procedure command. Refer to Appendix 
D for the format of this command. 


Example 1 

This example shows how to specify that line 1 is to be switched and automatic 
answer. 

ALTERCOM 1,SWITCHED,AA 

Example 2 

This example shows how to change line 3 to a tributary station in a multipoint line. 
The tributary address is TT (hex value of EBCDIC E3). 

ALTERCOM 3,MULTTRIB,,,,E3 


The multipoint communications network could be viewed as the following: 


Host System 



Communications 
Line Number 3 




System A 
Addressing 
Character SS 


Your System 
Addressing 
Character TT 




System B 

Addressing 
Character UU 


S9082008-0 
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Example 3 


You have a display station that needs to use a switched line for part of the day and 
a nonswitched line for the remainder. The value in the system communications 
configuration record is nonswitched. To change to switched, you could; 

1. Physically connect a switched line to the correct system port. 

2. Use the ALTERCOM procedure command (from the display station that will 
use the line) to change the line type to switched. 

3. Use the line as switched from the display station. 

4. When complete, physically disconnect the switched line and reconnect the 
nonswitched line. 

To reset the line type to nonswitched, use the ALTERCOM procedure. 

If any other display station attempts to use the line as nonswitched while it is 
physically a switched line, the attempt will fail. 

Note: ALTERCOM does not change the values specified for a communications line 
member. A line member is defined and changed by using the CNFIGICF 
procedure command. 


2-12 Using S/36 Communications 



Tributary Station Addressing and Polling Characters 


The following charts show the addressing and polling characters that you can use 
for Systeni/$6 BSC tributary stations. Addressing and polling characters must be 
used together in certain pairs. That is, once an addressing character is selected, the 
complementary polling character must be used. The addressing and polling 
characters are assigned by the host system. 

EBCDIC Addressing and Polling Characters 


Addressing 

Character 

Hex Code 

Polling 

Character 

Hex Code 

SS 

E2 

BB 


TT 

E3 

CC 


UU 

E4 

DD 

C4 

vv 

E5 

EE 

C5 

ww 

E6 

FF 

C6 

XX 

E7 

GG 

Cl 

YY 

E8 

HH 

C8 

zz 

E9 

II 

C9 

11 

FI 

JJ 

D1 

22 

F2 

KK 

D2 

33 

F3 

LL 

D3 

44 

F4 

MM 

D4 

55 

F5 

NN 

D5 

66 

F6 

OO 

D6 

77 

F7 

PP 

D7 

88 

F8 

QQ 

D8 

99 

F9 

RR 

D9 
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ASCII Addressing and Polling Characters 


Addressing 

Character 

Hex Code 

Polling 

Character 

Hex Code 

aa 

61 

AA 

41 

bb 

62 

BB 

42 

cc 

63 

CC 

43 

dd 

64 

DD 

44 

ee 

65 

EE 

45 

ff 

66 

FF 

46 

gg 

67 

GG 

47 

hh 

68 

HH 

48 

ii 

69 

II 

49 

jj 

6A 

JJ 

4A 

kk 

6B 

KK 

4B 

11 

6C 

LL 

4C 

mm 

6D 

MM 

4D 

nn 

6E 

NN 

4E 

oo 

6F 

OO 

4F 

PP 

70 

PP 

50 

qq 

71 

QQ 

51 

rr 

72 

RR 

52 

ss 

73 

SS 

53 

tt 

74 

TT 

54 

uu 

75 

UU 

55 

vv 

76 

VV 

56 

ww 

77 

ww 

57 

XX 

78 

XX 

58 

yy 

79 

YY 

59 

zz 

7A 

ZZ 

5A 
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Chapter 3. Configuring for Communications 


Defining a configuration for Systeni/36 communications consists of defining a line 
member and a subsystem member. 

Many of the values specified during System/3 6 communications configuration must 
match values specified at the remote system. For example: 

• If System/36 is communicating with an SNA host, the local station address 
specified during System/36 configuration must match the value specified for 
the System/3 6 at the host. 

• If System/36 is communicating with a BSC system, the buffer lengths specified 
at both locations must match. 

• If System/36 is communicating with an APPC system, the location names must 
match. 

It is suggested that you work closely with the remote system personnel to obtain 
the needed information. 

You define the System/36 line and subsystem members by entering the 
CNFIGICF procedure command from any command-capable display station. The 
command has no parameters. The CNFIGICF procedure then presents a series of 
displays that prompt you for the needed configuration information. 


System/36 Communications Line Members 

A line member describes the physical characteristics of the communications line 
that will be used by System/36 communications and describes one or more remote 
systems with which System/36 will communicate. The information in the line 
description is needed to establish the connection with the remote system; it does 
not describe any specifics of the remote system or System/36. 

The physical characteristics of the line that are defined in the line member are: 

• The line type (switched or nonswitched) and, if the line type is switched, 
whether it is a manual call, manual answer, or autoanswer switch type 

• The error retry count (BSC only) 

• The data link protocol (SNA only) 
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The line member also describes the characteristics of the remote system(s) with 
which System/36 can communicate using the line member. 

For BSC MSRJE, you define the following for a remote system: 

• The name to be used by System/36 to refer to the remote system 

• The size of the buffers to be used for communications 

• The name of the phone list load member if the line is an X.21 switched line or 
an autocall switched line 

There are two types of SNA line members: 

• SNA/SDLC line members, which you define if you are going to use SNA on 
an SDLC line 

• SNA/X.25 line members, which you define if you are going to use SNA on an 
X.25 line 

For SNA, you define the following for a remote system: 

• The name to be used by System/36 to refer to the remote system 

• Whether the remote system is a host system, a terminal, or a Peer system 

• If the remote system is an SNA host, the logical units (LUs) that are to be used 
by each type of SNA communications subsystem (SSP-ICF SNUF, SNA 3270, 
SNA MSRJE, secondary APPC) 

• For a switched line, you also specify: 

— The switch type at ENABLE (inactive, autoanswer, manual answer, or 
manual call) 

- The switch type to be used when a session is initiated (call, autoanswer, or 
manual answer) if the switch type at ENABLE is inactive or autoanswer 
— The name of the phone list load member to be used if the line is an X.21 
switched line or if the autocall feature is used 

• For an SNA/X.25 line member, you also specify the name of a corresponding 
X.25 configuration member that contains X.25 information for each remote 
system that you configure. You must define this X.25 configuration member 
using the CNFIGX25 procedure after you define the SNA/X.25 line member. 
Refer to Chapter 4 for a description of the CNFIGX25 procedure. 

• For an asynchronous line member, you also should specify the name of the line 
member. For an asynchronous/X.25 line member, also specify the name of the 
X.25 virtual circuit configuration member, the number of remote systems the 
line can communicate with, and the names of these remote systems. 
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One remote system can be defined within a line member for a nonswitched line; 

1 to 32 remote systems can be defined within a line member for a switched line or 
for a primary multipoint nonswitched line. In general, the remote system definition 
describes the characteristics of one remote system. However, if the remote system 
is a host system, it could contain several subsystems, such as JES2, JESS, IMS, 
CICS, or RES. The remote system definition in the line member describes the 
characteristics of the remote system itself when System/3 6 is communicating with 
any of the subsystems at the remote system. 

The number of remote systems you define depends entirely on your 
communications environment. For example, if you will be using a nonswitched 
line, or a switched line to communicate with only one remote system, you would 
define only that system. If you will be using a switched line and will be 
communicating with more than one remote system, you would define each remote 
system. 

Note that the same remote system definition can be used by secondary APPC, 
SNA MSRJE, SNA 3270, or SSP-ICF SNA Upline FaciUty (SSP-ICF SNUF) for 
application programs or for the Distributed Systems Node Executive (DSNX) of 
Communications and System Management (C & SM). 


System/36 Communications Subsystem Members 

A subsystem member contains the information necessary for System/36 to 
communicate with one or more remote locations. For example, for MSRJE, a 
remote location definition describes the characteristics of one RJE subsystem (such 
as JES2 or RES) in a remote system (a remote system in the line member). 
Actually, since the remote system can have many RJE work stations defined, an 
MSRJE remote location describes one work station for one host system. 

When you define a subsystem member, you must specify the name of the line 
member that is to be used by the subsystem member. You then define the remote 
location for remote systems within the line member. When defining a subsystem 
member, you are shown the names of the remote systems that are defined within 
the associated line member. You then specify the name of the remote system for 
which you are defining a remote location. 

Many other items are defined for a subsystem member. Refer to the appropriate 
manual for a discussion of configuring a subsystem member. 
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Definii^ an SNA/SDLC or SNA/X.25 Line Member 


The displays in this section illustrate the definition of an SNA line member named 
SNALINEl. The remote system, within the line member, is called SNAHOSTl. 
The current library is SNALIB. 

You define the environment using the CNFIGICF procedure, which is run by 
entering the CNFIGICF procedure command (it has no parameters) on the 
command line from a display station. You are then prompted with a series of 
displays that allow you to define the communications environment. 

SNA subsystems can share the same line, with the following restrictions: 

• For an SNA/SDLC line: 

— The Peer primary, APPC primary, and Finance subsystems can share a line 
if they are configured for a nonswitched multipoint line; however, the 
APPC subsystem cannot share the same line member with the Finance 
subsystem. A line member that the APPC and Peer subsystem are sharing 
can run concurrently with a line member used by the Finance subsystem. 

In addition, remote work station support (RWS) can share this same line. 

— A Peer secondary subsystem cannot share a line with any other subsystem. 

- The SNA 3270, SNA MSRJE, APPC secondary, and SNUF subsystems 
can share a line if all the subsystems use the same line member. In 
addition, a SNUF subsystem used for Communications and Systems 
Management change management and an APPC subsystem used for 
Communications and Systems Management alert support can also share 
the line, if they use the same line member. SNA 3270 is described in the 
32 70 Device Emulation Guide, MSRJE is described in the Multiple Session 
Remote Job Entry Guide, and change management and alert support are 
described in the Communications and Systems Management Guide. 
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. For an SNA/X.25 line: 

— All SNA subsystems, including RWS, can share a line, but only one 

configuration of each may be enabled at one time on the line. You cannot 
enable Peer primary and Peer secondary or APPC primary and APPC 
secondary on the same line. Also, MSRJE, SNUF, 3270 Device 
Emulation, and APPC can share a line only if they use the same line 
member. Therefore, you cannot enable APPC primary and any of the 
other three on the same line. 

- The SNA 3270, SNA MSRJE, APPC secondary, and SNUF subsystems 
can share a line if all the subsystems use the same line member. In 
addition, a SNUF subsystem used for Communications and Systems 
Management change management and an APPC subsystem used for 
Communications and Systems Management alert support can also share 
the line, if they use the same line member. SNA 3270 is described in the 
3270 Device Emulation Guide, MSRJE is described in the Multiple Session 
Remote Job Entry Guide, and change management and alert support are 
described in the Communications and Systems Management Guide. 

Note: 3270 Device Emulation, MSRJE, SSP-ICF, and C & SM are separate 
features. 
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Display 1.0 SSP-ICF Configuration Member Definition 



Note: On this display and all displays that follow, you can press command key 7 to 
end the CNFIGICF procedure or press command key 19 to cancel the 
CNFIGICF procedure. Command key 7 saves any valid definitions you have 
performed and, if you are not on display 1.0, returns you to the SSP-ICF 
Configuration Member Definition display (1.0). If you press command key 7 
while on display 1.0, CNFIGICF ends. 

Pressing command key 19 immediately ends CNFIGICF. You lose any 
definitions you have performed since you last entered values for display 1.0. 

Help text is available throughout CNFIGICF by pressing the Help key. 

1 Configuration member name specifies the name for this configuration of the 
line. The name is used to store the member in a library, and is referenced in 
the subsystem configuration. SNALINEl is used for this discussion. 

2 Library name specifies the name of the library in which you want this member 
stored. The default library is the current user library (SNALIB in the 
example). It is recommended that you do not store the member in the system 
library (#LIBRARY) since members you store in #LIBRARY may be lost if a 
release update is later performed. 

3 Select one of the following: Specify the number (1 through 5) that corresponds 
to the operation you want to perform. The options are: 

1- Create new member allows you to specify the configuration values for a new 
line member. 

2- Edit existii^ member allows you to view and/or change the values previously 
specified for a line member. 
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3- Create new member from existing member allows you to use an existing line 
member as the basis for a new line member. You need change only those 
values necessary. The existing line member is unchanged by this option. 

4- Remove a member allows you to remove a line member from the library. 

Note that the definition is no longer available once it is removed. If any 
subsystem members reference the removed line member, an error will occur 
when you attempt to use the subsystem member. 

Note: If command key 7 is pressed after this option is specified, the member will 
not be deleted, and CNFIGICF will end. 


5-Review a member allows you to view the values specified for a line member. 
No changes can be made. 

If option 3 is selected for prompt 3, display 1.0 is updated with two additional 
prompts when the the Enter key is pressed. If any other option is selected, display 
2.0 is presented. 


Since a new line member is being created in the example, the next display would be 
display 2.0. However, to illustrate how display 1.0 is updated when option 3 is 
selected for prompt 3, the next display described is the updated version of display 


1 . 0 . 


1 .0 


SSP-ICF CONFIGURATION MEMBER DEFINITION 


1. Configuration member name 

2. Library name . 



SNALINE1 

SNALIB 


3. Select one of the following: 

1. Create new member 

2. Edit existing member 

3. Create new member from existing member 

4. Remove a member 

5. Review a member 

Option.1-5 3 

4. Existing member name . 


5. Existing member library name 


SNALIB 


Cmd7-End Cmdl9-Cancel 



4 Existii^ member name appears only if option 3 was selected for prompt 3. 
Specify the name of the existing line member that you want to use as the basis 
for a new line member. 

5 Existing member library name appears only if option 3 was selected for prompt 
3. Specify the name of the library in which the member named in prompt 4 is 
stored. The default library is the library specified for prompt 2. 


Chapter 3. Configuring for Communications 3-7 








Display 2.0 SSP-ICF Configuration Member Type 



SSP-ICF CONFIGURATION MEMBER TYPE 


SNALINE1 



Select one of the following options: 

1. INTRA 

2. BSC 

3. SNA 

4. Async 


Option: 


Cmd3-Previous display 



Cmdl9-Cancel 

COPR IBM Corp. 1986 



Note: On this display and all displays that follow for the line member configuration, 
the member name (SNALINEl in the example), as specified for prompt 1 on 
display 1.0, is shown in the upper right-hand corner. Pressing command key 3 
returns you to the previous display. 

Select one of the following options: 

1 Intra creates an Intra subsystem member. This is the only type of 
configuration member for Intra; a line member is not used. 

2 BSC creates a line member or a subsystem member for binary synchronous 
communications. 

3 SNA creates a line member or a subsystem member for systems network 
architecture communications. 

4 Async creates a line member or a subsystem member for asynchronous 
communications. 

When you press the Enter key, display 4.0 is presented so that you can specify the 

subsystem or line member you want to work with. 
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I Display 4.0 SNA Configuration Member Type 


4.0 


SNA CONFIGURATION MEMBER TYPE 


1. SNA member type . 

1. SNA subsystem member 

2. SNA/SDLC line member 

3. SNA/X.25 line member 


SNALINE1 
1,2,3 2 


W1 


2. Will APPC be used?.Y,N N 



Cmdl9-Cancel 

COPR IBM Corp. 1985 J 


1 SNA member type specifies the type of member you are defining. Specify 
option 2 (SNA/SDLC line member) if you are using an SDLC line. Specify 
option 3 (SNA/X.25 line member) if you are using an X.25 line. When you 
press the Enter key, prompt 2 is added to this display. 

2 Will APPC be used? Specify Y (yes) if this line member will be used for APPC 
communications. You must specify (Y) if this line member will be used for 

C & SM alerts, DDM, SSP-ICF APPC, Display Station Pass-Through, or by 
PS/36 for document distribution. Note that the same line member can be 
used for both APPC and non-APPC communications. 

N (no) specifies that the line member will not be used for APPC. 

When you press the Enter key, display 12.0 is presented so that you can define the 
attributes of the line. 
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Display 12.0 SNA Line Member Attributes 


12.0 SNA LINE MEMBER ATTRIBUTES 

1. Data link protocol . 

1-Primary 2-Secondary 

2. Line type . 

1-Nonswitched 2-Switched 3-X.21 Short Hold Mode 

4. X.25 configuration member name . 


SNALINE1 W1 



Cmdl9-Cancel 



1 Data link protocol specifies whether this is a primary or secondary system in 

the network. 

• If the line member is to be used by the Finance subsystem, by a primary 
Peer subsystem, or by an APPC primary subsystem, select option 1 
(Primary). 

• If the line member is to be used by MSRJE, SNA 3270, SNUF, DSNX, 
DHCF, a secondary Peer subsystem, or a secondary APPC subsystem, 
select option 2 (Secondary). 

Notes: 

1. When System!36 uses APPC to communicate with CICS/VS, System/36 is 
always secondary. 

2. When System/36 is using APPC to communicate with one or more 
System/36s, System/38s, Displaywriters, or 5520s, one system in the 
network must use primary protocol. All other systems must use secondary 
protocol. 

3. A secondary APPC subsystem that communicates with System/38, 

System/36, Displaywriter, or a 5520 cannot share a line member with other 
secondary subsystems. 

2 Line type specifies the type of communications line. The line can be either 

Nonswitched (option 1), Switched (option 2), or X.21 Short Hold Mode 

(option 3). 
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The value specified here should correctly identify the type of line you are 
going to use. If the line values do not match, a message is displayed when you 
enable a subsystem that uses this line member. You will then be given the 
option of using the values specified for this line member (SNA 3270, SNA 
MSRJE, APPC, C & SM, and SSP-ICF SNUF only) or canceling the 
ENABLE procedure. 

For an X.25 line member, this value specifies how you want to use the X.25 
line. The actual line will always be nonswitched, but if you select option 2 for 
this prompt, you can get the functions (like automatic calling) on a switched 
line. 

4 X.2S configuration member name appears only if you are defining an 

SNA/X.25 line member (option 3 on display 4.0). Specify the name of the 
X.25 configuration member that is to be used with the SNA/X.25 line 
member. This configuration member contains X.25 information for each 
remote system you configure. You must define this configuration member 
using the CNFIGX25 procedure after you define the SNA/X.25 line member. 
Refer to Chapter 4 for a description of the CNFIGX25 procedure. 

Note: The X.25 configuration member specified here does not currently exist. 

If you select option 1 for Data link protocol and option 1 or option 3 for Line type, 
display 12.5 is presented. Otherwise, display 12.0 is presented again with 
additional prompts. 



SNA LINE MEMBER ATTRIBUTES 


SNALINE1 



1. Data link protocol...2 

1-Primary 2-Secondary 

2. Line type.2 

1-Nonswitched 2-Switched 3-X.21 Short Hold Mode 

3. Switch type at ENABLE . 

1- Inactive 3-Manual answer 

2- Autoanswer 4-Manual call 


5. Local system's station address . 01-FE 

6. Local system's station XID in hexadecimal. 00000 


Cmd7-End 


Cmdl9-Cancel 
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3 Switch type at ENABLE when a subsystem configuration is enabled on a 
switched line using this line member, the switch type specified here is used. 
This prompt is only displayed if the line type is switched. 

The options are: 

1- Inactive: The line is not activated when the subsystem is enabled; it is 
activated when a session is started. Do not specify if using Finance, Peer, or 
DSNX. 

2- Autoanswer: System/36 will automatically answer a call from the remote 
system to establish the data link. This option is only valid if the modem used 
on the line has the autoanswer feature or if you are defining an X.25 line 
member. 

3- Manual answer: The operator must answer a call from the remote system 
and place the modem in data mode to establish the connection. This option 
does not appear if you are defining an X.25 line member. 

4- Manual call: The operator must place a call to the remote system to establish 
the data link. This option does not appear if you are defining an X.25 line 
member. 

5 Local system’s station address is only displayed when option 2 is selected for 
the Data link protocol prompt. Specify the hexadecimal address by which 
System/3 6 is known to the remote system. The value can be any hexadecimal 
number from 01 to FE. 

When using SNA MSRJE, SNA 3270, SSP-ICF SNUF, or APPC to 
communicate with a host, the value specified here must match the value 
specified for System/36 at the host system for the ADDR parameter of the PU 
macro during NCP/VTAM generation. 

For SSP-ICF Peer or APPC communications, this value must be the same as 
that specified at the remote system. 

• If the remote system is a System/36, this value must match the value 
specified at the remote system as its Remote system's station address on 
display 13.0 during CNFIGICF. 

• If the remote system is a System/38, this value must match the value 
specified as the CTLADR parameter on the CRTCUD (Create Control 
Unit Description) command. 

• If the remote system is a DisplayWriter, this value must match the value 
specified at the Displaywriter for the SDLC Link Address value on the 
Port, Modem, and Line Description menu during personalization of the 
Electronic Document Distribution (EDD) diskette. 

• If the remote system is 5520, this value must match the value specified in 
the Local address parameter of the Remote Device Profile. This parameter 
is used only if the System/36 is secondary. 
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6 Local system’s station XID in hexadecimal specifies the 5-hexadecimal character 
exchange identifier (XID) that is used to identify the System/36. The value 
can be from 00000 through FFFFF. When you are using SSP-ICF SNUF, 
SNA MSRJE, SNA 3270, or APPC communications to a host system, the 
value specified here must match the value specified for the System/36 by the 
IDNUM parameter of the PU macro on the switched line network definition 
during NCP/VTAM generation at the host system. 

If you are using APPC for peer communications, this value must match the 
value specified at the remote system: 

• If the remote system is a System/36, this value must match the value 
specified at the remote system as its Remote system’s stations XID in 
hexadecimal on display 13.0 during CNFIGICF. 

• If the remote system is a System/38, this value must match the value 
specified for the last 5 characters of the EXCHID parameter on the 
CRTCUD (Create Control Unit Description) command. (The first 3 
characters of the EXCHID parameter are the block ID). 

• If the remote system is a Displaywriter, specify 00000 since Displaywriter 
does not check the value. 

• If the remote system is a 5520, this value must match the value specified in 
the Security ID parameter of the Remote Device Profile. This value is a 
combined block ID - XID. 

The default is 00000. 
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Display 12.5 Remote System Selection 


^ 12.5 REMOTE SYSTEM SELECTION 

1. Select from the following options: 

1- Create 3-Create from existing 5-Review 

2- Edit 4-Remove 

Option... 

2. Remote system name . . . 

3. Existing remote system name. 


1 


OPTION REMOTE SYSTEM OPTION REMOTE SYSTEM OPTION REMOTE SYSTEM 



^^Cmd7-End CmdS-Reset Cmdl 9-Cancel _ ^ 


On this display, you select the remote systems this subsystem communicates with. 
If the line type is nonswitched and the protocol is secondary, only one remote 
system can be defined. If the protocol is primary or the line type is switched, up to 
32 remote systems can be defined. 

All previously defined remote systems are listed. You may edit, remove, or review 
any of these remote systems by entering the correct option number in the column 
to the left of the remote system with which you want to work. 

If no remote systems been defined, the only option shown on display 12.5 is 

1-Create and prompt 3 is not shown. 

1 Select from the following options: Specify which of the available options you 
want to use: 

1- Create defines a new remote system. 

2- Edit changes an existing remote system. 

3- Create from existing defines a new remote system using an existing remote 
system as a base. 

I 

4- Remove removes a remote system. It will no longer exist in this member. 

5- Review displays an existing remote system. The configuration member 
cannot be changed. 

2 Remote system name specifies the name (up to 8 characters) by which the 
remote system is to be known in the line member. You will later use and refer 
to this name during subsystem configuration on display 29.0. 

3 Existing remote system name specifies the name of the existing remote system 
that is to be used as a base when creating a new remote system if you selected 
option 3. 
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Display 13.0 Remote System Attributes 


Display 13.0 lets you define the characteristics of the remote system selected on 
display 12.5. 



13.0 REMOTE SYSTEM ATTRIBUTES SNALINEI 

Remote system SNAHOSTI 

1. Remote system type . 

1-Host 2-Peer 3-Terminal 

2. Remote system's station address.01-FE 

3. Remote system's block ID in hexadecimal.03E 

4. Remote system's station XID in hexadecimal . 00012 

5. Switch type for session initiation . ..... 3 

1-Call 2-Autoanswer 3-Manual answer 

6. Phone list name. . 

7. Automatic disconnect? . Y,N 

8. SSCP identification. 0-65535 

Cmd7-End Cmd19-Cancel 




..y 


Note: If you press command key 7 on display 13.0, you return to display 12.5. 

1 Remote system type specifies the type of system with which this line member 
will communicate. The allowed options are; 

1- Host, which must be selected for SNA MSRJE, SSP-ICF SNUF, SNA 3270 
Device Emulation, or when the line member will be used for APPC 
communications with a host system (such as CICS/VS). 

2- Peer, which must be selected when the line member is being defined for use 
by the SSP-ICF Peer subsystem or for use by APPC communications with a 
peer (APPC) system. 

3- Temiinal, which is valid only when the line member is being defined for the 
SSP-ICF Finance subsystem. 

2 Remote system’s station address is only shown when the data link protocol is 
primary. Specify the hexadecimal address by which the remote system is 
known to the System/36. The value can be any hexadecimal value from 01 to 
FE. If you are using APPC for peer communications, this value must match 
the value specified at the remote system: 

• If the remote system is System/36, this value must match the value 
specified at the remote system as its Local system's station address on 
display 12.0 during CNFIGICF. 

• If the remote system is System/38, this value must match the value 
specified for the STNADR parameter on the CRTLIND (Create Line 
Description) command. 


For the SSP-ICF Finance subsystem, it must be the same as the control unit 
address. 


Chapters. Configuring for Communications 3-15 











This address must be unique among all remote systems, including Finance 
terminals, Peer systems, and remote work station controllers, that can be 
connected to the line at one time. 

3 Remote system’s block ID in hexadecimal is only shown when the line member 
is to be used by APPC and the remote system type is peer (option 2 for 
prompt 1 on this display). Specifies the 3-hexadecimal character block 
identifier of the remote system. This value can be from 000 to FFF and must 
be the same as the value assigned to the remote system by SNA. Those values 
are: 


• For System/36,03E 

• For System/38, 022 

• For Displaywriter, 03A 
. For 5520, 031 

4 Remote system’s station XID in hexadecimal specifies the exchange identifier 
(XID) used to identify the remote system. This identifier is five hexadecimal 
characters from 00000 through FFFFF. This value must match the value 
specified at the remote system (the remote system must use secondary 
protocol). 

• If APPC is not used for this line member, this prompt is only shown if the 
remote system type is Peer and the data link protocol is primary. 

• If APPC is used for this line member, this prompt is shown if the remote 
system type is Peer. The data link protocol can be primary or secondary. 

• If the remote system is a System/36, this value must match the value 
specified at the remote system as its Local system's station XID in 
hexadecimal. 

• If the remote system is a System/38, this value must match the value 
specified as the last 5 characters of the EXCHID parameter on the 
CRTLIND (Create Line Description) command. If an EXCHID is not 
specified at the CRTLIND command, the System/38 automatically 
generates a value. The System/38 command DSPLIND (Display Line 
Description) can be used to determine the correct value. The first 3 
characters are always 022. 

• If the remote system is a Displaywriter, this value must match the value 
specified at the remote system as its Physical Unit ID on the Modem and 
Line Description menu. 

• If the remote system is a 5520, this value must match the value specified in 
the 5520’s Remote System Security ID parameter of the Remote System 
Profile. This value is a combined block ID - XID on 5520. 
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5 Switch type for session initiation appears only if the Switch type at ENABLE 
prompt on display 12.0 was specified as 1 (Inactive) or 2 (Autoanswer). 
Specifies, for a switched line, how the data link will be established when a 
session is started on a switched line using this line member. Allowed responses 
are: 

1- Call specifies that System/3 6 will establish the connection. Either the 
operator will place a call or, if autocall, X.21 switched, or X.25 is used, 

System/3 6 will automatically place the call (if a phone list name is specified for 
prompt 6). 

2- Autoanswer indicates that System/3 6 will automatically answer an incoming 
call from the host system to establish the connection. 

3- Manual answer indicates that the operator must manually answer an 
incoming call from the host system to establish the connection (does not 
appear if you are defining an X.25 line member). 

The switch type specified should match the value specified for the line in the 
configuration record. 

6 Phone list name Enter a value here only if your system has the autocall, X.21 
switched, or X.25 feature with switched virtual circuits and you want 
System/36 to automatically attempt to connect to the remote system. The 
value specified is the name of the phone list load member containing a list of 
phone numbers (autocall), public data network numbers (X.21 switched), or 
network addresses (X.25). 

The phone list load member is created by the DEFINEPN (autocall), 
DEFINX21 (X.21), or DEFINX25 (X.25) procedure, as described in Chapter 
5. The phone list load member must be stored either in the same library as the 
line member or in the system library. 

The prompt will say 6. Phone number if the line type is X.21 SHM. You 
should specify the telephone number of the remote system on an X.21 SHM 
line. 

7 Automatic disconnect? specifies, for a switched line only, whether you want the 
line to be automatically disconnected when the last communications session 
ends. Y (yes) specifies that an attempt will be made to disconnect the line; N 
(no) specifies that no attempt will be made. 

Note: Specifying N (no) for Automatic disconnect? does not prevent the line 
from being disconnected automatically. If the remote system specifies 
automatic disconnect, the remote system will attempt to disconnect the 
line. 

8 SSCP identification specifies the system services control point identifier 
assigned to the host system. This prompt is only displayed when the remote 
system is a host. Valid entries are 0 through 65535. If you specify 0, you can 
communicate with any host, regardless of the SSCP identification of that host. 

Note: If you are using a switched line, you can specify 0 for only one remote 
system. 
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The value specified here must match the value specified in the START procedure 
for ACF/NCP/VTAM. 

If you are defining a secondary protocol line member and the remote system is a 
host, display 14.0, which allows you to define logical unit sessions, is presented 
when you press the Enter key. Otherwise, display 12.5 is presented. 

Display 14.0 Remote System Logical Unit Assignments 


Display 14.0 is presented after display 13.0 only if: 

1. The Data link protocol is specified on display 12.0 as 2 (secondary), and 

2. The Remote system type on display 13.0 is specified as 1 (host). 


14.0 

REMOTE 

SYSTEM LOGICAL 

UNIT ASSIGNMENTS 


SNi 

Specify 
A-SNUF, 
LU Code 

the subsystem associated with each 
B-3270, C-MSRJE, D-APPC, E-DHCF 

LU Code LU Code LU Code LU Code 

LU: 

LU Code 

LU Code 

LU ( 
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54 

55 

56 
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64 


SNALINE1 


ROLIi-Page Cmd3-Previous Display CmdV-End 


Cmd19-Cancel 


W1 


Each remote system has up to 255 logical units (LUs) available for 
communications. These LUs can be used by SNA MSRJE, SSP-ICF SNUF 
(including DHCF and DSNX), APPC, or SNA 3270 Device Emulation. 

Note: Only one LU can be assigned to APPC. That LU must be shared by all APPC 
applications to the host system (alerts, SSP-ICF, and PS/36). 

This display allows you to specify which of the possible 255 logical units are to be 
used by each. Use the Roll t kev or the Enter key to advance to the next display of 
logical sessions, or use the Roll t key to go back to the previous display (64 LUs 
are shown on each display, except the last, which has 63). 

You should perform this assignment of LUs in close coordination with the host 
system personnel. If the host system is a 370, 30xx, or 43xx, the logical units are 
defined during NCP/VTAM generation at the host system using LU macros. Each 
LU is assigned an address with the LOCADDR parameter. You must ask the host 
system personnel which of these LUs are assigned to each type of communications 
support. 
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Once you have selected the needed LUs and pressed command key 7 (or the Enter 
key if you are on the last of the LU displays), you have completed defining a line 
member, and display 12.5 is presented. You can then specify the values for another 
remote system, or you can press command key 7 to return to display 1.0. Once 
display 1.0 is presented, you can end the CNFIGICF procedure by pressing 
command key 7, begin defining another line member, or define a subsystem 
member. 

Notes: 

1. If the line member being defined will be shared by any combination of subsystems, 
SNA MSRJE, APPC, SNA 3270 device emulation, the SSP-ICF SNA Upline 
Facility (SNUF) subsystem for application programs, the Distributed Systems 
Node Executive (DSNX) and remote system management (DHCF) of 
Communications and Systems Management (C & SM), the LUs assigned here 
must match the LU assignments performed at the host system. 

For example, if SNA MSRJE is to use LUs 1 through 10 (as defined by the 
LOCADDR parameter at the host for the NCP/VTAM generation), you specify C 
next to those LUs on display 14.0. If SNA 32 70 device emulation is to use LUs 
11 through 20, you specify B next to those LUs on display 14.0. If SNUF is to 
use LUs 21 through 30 for application programs and LU 21 for the DSNX 
support of C & SM, you specify A next to those LUs on display 14.0. 

2. Only one LU can be assigned to be used by SNUF for DSNX. If multiple LUs 
are also used for SNUF applications, the first LU of those assigned to SNUF 
must be used by DSNX. 

You should work closely with the people responsible for SNA 32 70 device 
emulation, SNA MSRJE, SNUF, APPC, and C & SM at your site and with the 
person responsible for the NCP/VTAM generation at the host when you assign 
these LUs. 

3. Once you assign an LU to a subsystem on display 14.0, that LU cannot be used by 
any of the other subsystems. For example, if you assign an LU to MSRJE, it 
cannot be used by APPC, SNUF, or SNA 32 70 device emulation. If you need to 
change an LU assignment from one subsystem to another, you must edit the line 
member (option 2 of prompt 3 on display 1.0 of CNFIGICF). 
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Defining a BSC Line Member 


The displays in the following sections illustrate the definition of a BSC line member 
named BSCLINEl. The current library is BSCLIB. 

Display 1.0 SSP-ICF Configuration Member Definition 


1.0 


SSP-ICF CONFIGURATION MEMBER DEFINITION 


W1 


1. Configuration member name 

2. Library name . 


BSCLINEl 

BSCLIB 


Select one of the following: 

1. Create new member 
Edit existing member 

Create new member from existing member 
Remove a member 
Review a member 


2 . 

3. 

4. 

5. 

Option 


1-5 


Cmd7-End Cmdl9-Cancel 

Help text available throughout CNFIGICF by pressing the help key 





Note: On this display and all displays that follow, you can press command key 7 to 
end the CNFIGICF procedure or press command key 19 to cancel the 
CNFIGICF procedure. Command key 7 saves any valid definitions you have 
performed and, if you are not on display 1.0, returns you to the SSP-ICF 
Configuration Member Definition display, display 1.0. If you press command 
key 7 while on display 1.0, CNFIGICF ends. 

Pressing command key 19 immediately ends CNFIGICF. You lose any 
definitions you have performed since you last entered values for display 1.0. 

Help text is available throughout CNFIGICF by pressing the Help key. 

1 Conf^iuration member name specifies a name for this configuration of the line. 
The name is used to store the member in a library and is referenced in the 
subsystem configuration. No default is provided. In this example, the line 
member name is BSCLINEl. 

2 Library name specifies the name of the library in which you want this member 
stored. The default library is the current user library (BSCLIB for this 
example). It is recommended that you do not store the member in the system 
library (#LIBRARY) because members you store in #LIBRARY may be lost if 
a release update is later performed. 
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3 Select one of the following: Specify the number (1 through 5) that corresponds 
to the operation you want to perform. The options are: 

1- Create new member allows you to specify the configuration values for a new 
line member. 

2- Edit existii^ member allows you to view and/or change the values previously 
specified for a line member. 

3- Create new member from existing member allows you to use an existing line 
member as the basis for a new line member. You need change only those 
values necessary. The existing line member is not changed. 

4- Remove a member allows you to remove (delete) a line member from the 
library. Note that the definition is no longer available once it is removed. If 
any subsystem members reference the removed line member, an error occurs 
when you attempt to use the subsystem member. 

Note: If command key 7 is pressed after this option is specified, the member will 
not be deleted, and CNFIGICF will end. 

5- Review a member allows you to view the values specified for a line member. 
No changes can be made. 

If you select option 3 for prompt 3, display 1.0 is updated with two additional 
prompts when you press the Enter key. If you select any other option, display 2.0 is 
presented. 
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Because a new line member is being created in the example, the next display would 
be display 2.0. However, to illustrate how display 1.0 is updated when option 3 is 
selected for prompt 3, the next display described is the updated version of display 
1 . 0 . 




1.0 


SSP-ICF CONFIGURATION MEMBER DEFINITION 


1. Configuration member name 

2. Library name . 


W1 


BSCLINE1 

BSCLIB 


3. Select one of the following: 

1. Create new member 

2. Edit existing member 

3. Create new member from existing member 


4. Remove a member 

5. Review a member 

Option.1-5 3 

4. Existing member name . 

5. Existing member library name . BSCLIB 

Cmd7-End Cmdl9-Cancel 


Help text available throughout CNFIGICF by pressing the help key ^ 



4 Existing member name appears only if option 3 is selected for prompt 3. 
Specify the name of the existing line member that you want to use as the basis 
for a new line member. 

5 Existing member library name appears only if option 3 is selected for prompt 3. 
Specify the name of the library in which the member named in prompt 4 is 
stored. The default library is the library specified for prompt 2. 
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Display 2.0 SSP-ICF Configuration Member Type 


2.0 


SSP-ICF 


Select one of the following 

1. INTRA 

2. BSC 

3. SNA 

4. Async 

Option: _ 


CONFIGURATION MEMBER TYPE 
options: 


BSCLINE1 



CmdS-Previous display 



Cmd19-Cancel 

COPR IBM Corp. 1986 I 


Note: On this display and all displays that follow for the line member configuration, 
the member name (BSCLINEl in the example), as specified for prompt 1 on 
display 1.0, is shown in the upper right-hand corner. Pressing command key 3 
returns you to the previous display. 

Select one of the following options: 

1 Intra creates an Intra subsystem member. This is the only type of 
configuration member for Intra; a line member is not used. 

2 BSC creates a line member or a subsystem member for binary synchronous 
communications (BSC). 

3 SNA creates a line member or a subsystem member for systems network 
architecture (SNA) communications. 

4 Async creates a line member or a subsystem member for asynchronous 
communications. 

When you press the Enter key, display 3.0 is presented so that you can specify the 

subsystem or line member you want to work with. 
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I Display 3.0 BSC Configuration Member Type 


3.0 


BSC CONFIGURATION MEMBER TYPE 


1. BSC member type . 

1. BSC subsystem member 

2. BSC line member 


2. Is this for MSRJE? 


BSCLINE1 

1,2 2 



Y,N N 



Cmd19-Cancel 

COPR IBM Corp. 1986 I 


1 BSC member type specifies the type of member that you are defining. Specify 
option 2 (BSC line member). 

2 Is this for MSRJE? Specify Y (yes) if it is for MSRJE. 

When you press the Enter key, display 10.0 is presented so that you can define the 
communications characteristics of the line. 
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Display 10.0 BSC Line Member Attributes 


r 


10.0 


BSC LINE MEMBER ATTRIBUTES 


BSCLINE1 


1. Line type . 

1-Multipoint 2-Nonswitched pt-pt 3-Switched pt-pt 

2. Error retry count . 1-255 7 

3. Local station address in hexadecimal . 

4. Switch type at ENABLE. 2 

1-Inactive 2-Answer 



5. Switch type for session initiation 
1-Manual call 2-Autoanswer 


CL. -- 


. 1 

3-Manual answer 


c 


1 Line type specifies the type of communications line. The options are: 

1- Multipoint, you are using a multipoint communications line. Specify 
multipoint for BSC 3270 or the SSP-ICFIMS/IRSS subsystem. 

2- Nonsmtched pt-pt, the communications line is a nonswitched point-to-point 
line. 

3- Switched pt-pt, the communications line is a switched point-to-point line. 

The value specified here should correctly identify the type of line you are going 
to use. If the line values do not match, a message is displayed when you enable 
a subsystem that uses this line member. You will then be given the options of 
using the values specified for this line member or of canceling the ENABLE 
procedure. 

2 Error retry count specifies the number of times a receive or transmit operation 
is to be retried when an error occurs before the error is considered permanent. 
Any decimal number from 1 through 255 can be entered. The default value is 
7. 

You should increase the Error retry count value if numerous errors occur on the 
communications line. 
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3 Local station address in hexadecimal specifies the hexadecimal address by which 
the System/36 is known to the host system. This prompt is shown only when 
the line type (prompt 1) is multipoint (option 1). 

Specify two hexadecimal characters from the following ranges: 

• For EBCDIC: C2 through C9 and D1 through D9. BSC 3270 also allows 
40, 4A through 4F, and 5A through 5F. 

. For ASCII: 41 through 5A. 

4 Switch type at ENABLE is only displayed when the line type is switched. The 
prompt is not displayed if the line member is for MSRJE. For MSRJE, 1 
(Inactive) is assumed. 

When a subsystem is started using the ENABLE procedure command, you can 
specify how you want the switched line to operate. The options are: 

1- Inactive, the line is not activated until the subsystem is started. 

2- Answer, System/36 automatically answers calls from the remote system. 

5 Switch type for session initiation specifies the switch type when communications 
is started on a switched line using this line member. The options are: 

1- Manual caU, the operator must place a call to the remote system to establish 
the data link. If a phone list is specified later in configuration, System/36 
automatically calls. 

2- Autoanswer, System/36 will automatically answer a call from the remote 
system to establish the data link. This option is only valid if the modem used on 
the line has the autoanswer feature. 

3- Manual answer, the operator must answer a call from the remote system and 
place the data set in data mode to establish the connection. 

Once you have completed display 10.0, the line definition is complete. If you are 
defining a line member for use by MSRJE, display 10.5, which allows you to define 
the characteristics of the remote system, is shown. If the line member is not for 
MSRJE, display 1.0 is shown. You can then define another line member, define a 
subsystem member, or end CNFIGICF. 
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Display 10.5 Remote System Selection 


This display is shown only if the line member is for MSRJE, 

Display 10.5 allows you to define the remote systems with which System/3 6 can 
communicate using this line member. If the line member is for a switched line, you 
can define up to 32 remote systems. If you are defining a line member for a 
nonswitched line, only one remote system can be defined. System/36 can 
communicate with only one of those systems at one time. 



On this display, you select the remote systems this subsystem communicates with. 

All previously defined remote systems are listed. You may edit, remove, or review 
any of these remote systems by entering the correct option number in the column 
to the left of the remote system with which you want to work. 

If no remote systems have been defined, the only option shown on display 10.5 is 

1-Create and prompt 3 is not shown. 

1 Select from the following options: Specify which of the available options you 
want to use: 

1- Create defines a new remote location. 

2- Edit changes an existing remote location. 

3- Create from existing defines a new remote location using an existing remote 
location as a base. 

4- Remove removes a remote location. It will no longer exist in this member. 

5- Review displays an existing remote location. The configuration member 
cannot be changed. 


Chapter 3. Configuring for Communications 3-27 







2 Remote system name specifies the name (up to 8 characters) by which the 
remote system is to be known in the line member. You will later use and refer 
to this name during subsystem configuration on display 29.0, 

3 Existing remote system name specifies the name of the existing remote system 
that is to be used as a base when creating a new remote system if you selected 
option 3. 


Display 11.0 Remote System Attributes 

Display 11.0, which is shown only when the line member is for MSRJE, allows you 
to define or update the characteristics of the remote system selected on display 
10.5. 



REMOTE SYSTEM ATTRIBUTES 


BSCLINE1 



1. Phone list name . 

2 . Buffer length . 200-4096 


Cmd7-End Cmdl9-Cancel 



1 Phone list name appears only if you are defining a switched line. You should 
enter a value here only if the autocall feature or the X.21 switched feature is 
used for the line. The value specified is the name of the phone list member 
that is to be used for the autocall feature or for an X.21 switched line. The 
phone list is created by the DEFINEPN or DEFINX21 procedure, as 
described in Chapter 5. 

If you specify a Phone list name, the switch type at session initiation specified 
on display 10.0 is used only if the call cannot be completed using the Phone list 
name. 

The specified phone list member must be stored in either the same library as 
the line member or in the system library. 
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2 Buffer length specifies the size of the transmit buffer, from 0200 to 4096 
characters, that is to be used. This value is dependent on the specification 
made during the host system generation. The values for the supported BSC 
host systems are; 

• JES2 default is 400, specified on the &MLBFSIZ JES2 initialization 
parameter. 

• JESS default is 400, specified on the B subparameter in the RJPTERM 
statement during JESS work station definition. 

• RES default is 512, specified on the TPBFSIZ parameter of the RTAM 
macro during stage 2 of RTAM generation at the host system. 

• RSCS default is 400, specified on the B parameter of the START 
command. 

Note: You must enter a 4-character value. For example, enter 200 as either 
0200 or 200 (a blank in front of the value). 

Display 10.5 is displayed again after you have entered your selections. If you want 
to define another system, select option 1 and enter a remote system name. To end 
the definition of the remote system characteristics, press command key 7. 

The definition of the line member is completed, and display 1.0 is presented. You 
can specify the values for another line member or begin the definition of a 
subsystem member. 
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Chapter 4. Definii^ and Maintaining an X.25 Configuration 


Description 


With X.25 support, you can use a System/36 with X.25 to communicate over a 
packet-switched data network (PSDN) with a compatible host or terminal that also 
has X.25 support. The X.25 support acts as an interface between System/36 
communications subsystems and X.25. X.25 is the interface to the packet switched 
data network using the X.25 communications protocol. 

For an overview discussion of X.25 communications, see the Data Communications 
Concepts manual. 


Components of X.25 Support 

When you use X.25 on System/36, you use three X.25 utilities to define and 
maintain the X.25 environment. These utilities are: 

• Configuring for X.25: You use the X.25 Configuration (CNFIGX25) Utility to 
define the network configurations, logical channel configurations, and virtual 
circuit configurations. 

The information you define during CNFIGX25 is linked to the associated 
remote work station (RWS) or SNA SSP-ICF configuration. Remote work 
stations are defined during system configuration (by the CNFIGSSP 
procedure) and SSP-ICF configuration members are defined using the 
CNFIGICF procedure command. The RWS or SSP-ICF configuration that is 
to use an X.25 configuration must be defined before an associated virtual 
circuit configuration is defined (using CNFIGX25). 

An SSP-ICF line member or an RWS configuration is linked to an X.25 
configuration through a common name. When defining an RWS configuration 
(during system configuration with the CNFIGSSP procedure) or an SSP-ICF 
SNA/X.25 line member (using the CNFIGICF procedure), you must specify 
the name of the associated X.25 configuration member. Therefore, you must 
decide before you define an RWS or SSP-ICF configuration what the X.25 
configuration member is to be called. 
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• Maintaining an X.25 link; You use the X.25 Maintenance (MAINTX25) Utility 
to display information about the X.25 links or to change certain virtual circuit 
parameters. 

• Defining a phone list for X.25: You use the Define X.25 Phone List 
(DEFINX25) Utility to create, edit, print, or remove a list of remote network 
addresses. When System/3 6 initiates the call on a switched virtual circuit, the 
network addresses in this list are called sequentially until a virtual circuit is 
established. Each address is called a prescribed number of times (retry). When 
System/3 6 is to answer a call on a switched virtual circuit, the call is accepted 
and the virtual circuit is established if the network address for the calling 
station is found in the list. If it is not found, the call request is rejected. 

System/36 Requirements 

X.25 programming is supported on System/36 with a minimum of 256K bytes of 
main storage. X.25 support uses 32K bytes of nonswappable storage and 24K 
bytes of swappable storage. 

The X.25 configuration utility, the X.25 maintenance utility, and the define X.25 
phone list utility each require 24 K-bytes of swappable main storage when loaded. 

For a System/36 Model 5360 System Unit with the MLCA (multiline 
communications adapter), X.25 programming support requires that the X.25 
feature be installed on either lines 1 and 2 or Unes 3 and 4. Note that the X.25 
feature requires two MLCA lines. Communications actually occurs on line 1 or 
line 3. 

For a System/36 Model 5360 System Unit with the ELCA (eight line 
communications adapter), one to three X.25 lines can be configured with the 
following conditions: 

• If one X.25 line is configured, it can be any of the eight lines. The other 
communications lines are available for use by other protocols (such as 
asynchronous, BSC, or SNA/SDLC). 

• If two X.25 lines are configured, they can be any two lines except line 8, which 
is reserved. Therefore, only five lines are available for use by other protocols. 

• If three X.25 lines are configured, they can be any three lines except lines 7 
and 8, which are reserved. This leaves three lines to be used by other 
protocols. 

For a System/36 Model 5362 System Unit, X.25 requires that the MLCA be 
installed. One to three X.25 lines can be configured. These can be any of the four 
communications lines. No lines are reserved. 
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Remote Systems Supported 


Using the X.25 support (consisting of the X.25 feature and the X.25 programming 

support), System/36 can communicate with the following devices over a PSDN: 

System/36 The other System/36 must be using the X.25 support. 

System/34 The System/34 must be attached to the PSDN through 

an IBM 5973 Network Interface Adapter (NIA). 

System/38 The System/38 must be attached to the PSDN through 

an IBM 5973 Network Interface Adapter (NIA) or use 
the integrated X.25 adapter. 


Remote Work Stations The controller must be a 5251 Model 12 with an 

Integrated X.25 Adapter (IXA); or a 5294 Control 
Unit. 


System/370, host The System/370 host must be using the X.25 support 

PRPQ/PP in its 370X TP controller. 

4331 The 4331 must be using an integrated X.25 adapter 

(IXA). 

4700 Finance System The 4700 must be using an integrated X.25 adapter 

(IXA) or an IBM 5973 Network Interface Adapter 
(NIA). 


Note: Communications between a System/36 with X.25 support and a system that 
uses an IBM 59 73 NIA is supported for migration purposes only. System/36 
X.25 is capable of handling the NIA protocol (PSH, physical services header). 
However, this does not imply any improvement for error recovery problems 
associated with an NIA product when attached to a faulty network. Systems 
such as System/34, when connected to a PSDN through an NIA, have no 
awareness of the NIA protocol conversion (SDLC to X.25) that occurs in the 
NIA. Therefore, these products do not specifically support attachment to a 
PSDN. Consult the documentation for the specific product to determine its 
level of support. 
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Before Using X.25 


Before you can use X.25 to communicate with a remote system or device, you must 
define a configuration for X.25 support. This is a 4-step process (as shown in 
Figure 4-1) that must be repeated for each of the X.25 lines. 
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Fl^e 4-1. X.25 Installation and Configuration Process 


The X.25 programming support is installed when the SSP features are 
selected (display 21.0 of CNFIGSSP) during system configuration. 


If you are using X.25 support for remote work stations, a configuration 
member that uses X.25 for remote work station support is defined 
during system configuration. The name of the associated X.25 virtual 
circuit configuration is specified on display 9.0 during CNFIGSSP 
remote work station definition. You must later use the same name on 
display 5.0 during X.25 virtual circuit configuration (CNFIGX25 
utility). The remote work station configuration and the X.25 virtual 
circuit configuration must be stored in the same library. 
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Note: The default library for system configuration members (as created 
by CNFIGSSF) is $CNFGLIB. 

See the manual Performing Hk First Systan Configuration far 
Your System or the manual Chaining Your System Configuration 

for the description of remote work station configuration. 

If you are using X.25 support for an SSP-ICF subsystem, an SNA/X.25 
line member is defined using the CNFIGICF procedure. See the manual 
System Reference for more about the CNFIGICF procedure. The name 
of the associated X.25 virtual circuit configuration is specified on 
display 12.0 during SNA/X.25 line member definition. You must later 
use the same name on display 5.0 during X.25 virtual circuit 
configuration (CNFIGX25 utility). The SSP-ICF line member and the 
X.25 virtual circuit configuration member must be stored in the same 
library. 

The X.25 configuration utility (CNFIGX25) is used to define the 
network, logical channel, and virtual circuit configurations. The X.25 
network and logical channel configuration members can be defined a 
number of times and given a unique name to associate to each of the 
X.25 lines. The member name can be used for the virtual circuit 
configuration member name; the member names are stored in #X25LIB. 

The network and logical channel part of X.25 configuration defines 
network subscription information such as the number of logical channels 
subscribed to, the type of network, the network packet size, and the 
type of logical channel (switched or permanent). 

In this step, the virtual circuits to be used are defined. Once again, the 
CNFIGX25 utility is used. Note that step 3 (network and logical 
channel configuration) must have been previously performed and that 
the RWS or SSP-ICF configuration must have been previously defined. 

On display 5.0 of CNFIGX25, you specify the name of the X.25 virtual 
circuit configuration member. This name must match the value 
specified on display 9.0 during CNFIGSSP for the remote work station 
definition or, if SSP-ICF is used, the name specified on display 12.0 
during SSP-ICF line member definition. 

In addition, you must specify the name of the associated RWS member 
(specified on display 3.0 during CNFIGSSP) or the associated SSP-ICF 
line member (specified on display 1.0 during CNFIGICF line member 
definition). 

You must also specify the name of the associated network configuration 
you created during step 3 (Network and Logical Channel 
configuration). 
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Figure 4-2 shows the relationships among the members used for X.25 with remote 
work stations; and Figure 4-3 shows the relationships among the members used 
for X.25 with an SSP-ICF subsystem. 
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Figure 4-2. Relation of RWS and X.25 Members 
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Figure 4-3. Relation of SSP-ICF and X.25 Members 
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Installing X.25 Support 


X.25 support can be installed on System/36 during the initial system configuration, 
or when you change the system configuration. In either case, the CNFIGSSP 
procedure is used to describe your System/36 environment. 

X.25 support is installed during the program products definition of the SSP (System 
Support Program Product). For a complete description of installing the program 
products including X.25, refer to the manual Changing Your System Configuration. 


Configuration Requirements 

You use the X.25 configuration utility to enter the X.25 network subscription data 
and to select parameters for each virtual circuit you create. This procedure must be 
repeated for each X.25 line. 

Before you can configure the X.25 support (using the CNFIGX25 procedure), you 
must define either remote work stations (during system configuration using the 
CNFIGSSP procedure) or an SSP-ICF subsystem configuration (using the 
CNFIGICF procedure). If you change an RWS or SSP-ICF configuration, you 
must use the X.25 configuration utility to edit the associated X.25 configuration. 

Use the X.25 configuration utility to define each virtual circuit, whether it is a 
permanent virtual circuit (PVC) or a switched virtual circuit (SVC). 

For an SVC, the logical channel can be configured for incoming calls only, 
outgoing calls only, or both. 

Note: The connection between System/36 and the X.25 network is always over a 
nonswitched communications line. However, System/36 supports both 
switched and permanent virtual circuits. 

System/36 supports a maximum of 16 logical channels per line, which are 
numbered 1 through 16 (see Figure 4-4). Each logical channel supports either a 
PVC or an SVC. One to three X.25 lines can be defined. One to 64 virtual 
circuits can be defined for a line, but only 16 can be active at any one time. 

Note: Both the network and virtual circuit configurations from the previous release 
must be updated. To update the network and logical channel configurations, 
edit the existing network and logical channel configuration (X25NCFGD) and 
create any new network and logical channel configurations needed for 
additional X.25 lines (if any). To update the virtual circuit configurations edit 
the X.25 configuration members and, when prompted, fill in the network and 
logical channel configuration member to be associated with the X.25 
configuration member. 
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Logical channels are connected to virtual circuits in the following order (see 
Figure 4-4). 


1 . 

2 . 

3. 

4. 


PVCs 

Incoming-only SVCs 
Incoming and outgoing SVCs 


Outgoing-only SVCs 
Call Direction: 


I-In Only —i 

I 4 4 4 1 


In/Out 


Out Only 


Tl 


I--m/uu!-1 I— 

I I 1 1 1 1 



To Remote Stations 
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F^ure 4-4. Systein/36 X.25 Logical Channel Configuration Example 
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Figure 4-4 illustrates a typical logical channel configuration. Logical channels 1 
through 7 are permanent and reserved for PVCs, while logical channels 8 through 
16 are switched and reserved for SVCs. The SVC logical channels are divided into 
three classes: in only, both (in and out), and out only. An incoming call is assigned 
to the first available logical channel defined for incoming calls, starting with the 
first logical channel for incoming SVCs (channel 8) and ending with the last logical 
channel for both SVCs (channel 13). 

Similarly, the system places outgoing calls on the first available logical channel, 
starting with the last logical channel available for outgoing only SVCs (channel 16) 
and ending with the first logical channel available for both SVCs (channel 11). The 
middle three channels can be used by incoming and outgoing calls. 

If you request an SVC connection when no logical channel is available, your 
request is placed on one of two queues, depending on whether it is an incoming or 
outgoing connection. If you request an SVC connection for station test and no 
logical channel is available, the request is rejected. 

If you configure an SSP-ICF subsystem with a phone list (autocall), you must 
configure at least one logical channel as an SVC with an outgoing direction. 

If you configure an RWS configuration or an SSP-ICF subsystem for autoanswer, 
you must configure at least one logical channel as an SVC with an incoming 
direction. 


Configuration 


System/36 X.25 programming support allows a station on a nonswitched line to be 
associated with either a PVC or an SVC, which is similar to conventional 
point-to-point nonswitched communications. 

System/36 X.25 programming support also allows the association of multiple 
stations on a nonswitched line to either PVCs or SVCs, which is similar to 
conventional multipoint nonswitched communications. Each station configuration 
must have a corresponding virtual circuit configuration. Each virtual circuit defined 
as switched can be independently configured for outgoing or incoming call 
establishment. 

You can configure more stations than the available number of logical channels. If 
no logical channels are available, any connection requests requiring a logical 
channel for an SVC configured for outgoing calls are placed on a queue and 
assigned a logical channel as soon as one becomes available. 
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Switched Configuration 


System/36 X.25 programming support allows the association of a single station 
switched line to an SVC as shown in Figure 4-5. 
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F^ure 4-5. Systein/36 X.25 Single Station Switched Configuration 

Any requests for SVCs configured for incoming calls are placed on a queue until a 
call arrives. This configuration requires at least one switched logical channel with 
an incoming call direction. 

Once the System/36 X.25 support is installed and configured, the operation of the 
X.25 network is transparent to the application programs, RWS, or SSP-ICF 
subsystems. 

If needed, you can use the X.25 maintenance utility to display the status of the 
X.25 links and to temporarily change some of the virtual circuit parameters. 
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Defining an X.25 Configuration 

You use either the CNFIGX25 procedure, which has no parameters, or the system 
prompt menus to start the X.25 configuration utility. 

The network and logical channel configurations are stored in #X25LIB in a 
member named by you; the virtual circuits are stored in the same library as the 
associated RWS or SSP-ICF configurations. 

Note: Tariff information for an X.25 configuration is stored in a file created by the 
configuration utility and cannot be transported from one system to another. If 
an X.25 configuration member is generated on one system and then used on 
other systems, each site must edit the configuration member (using 
CNFIGX25) to create the tariff files (if needed). 
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Figure 4-6 shows the flow of the X.25 configuration utility displays. 
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Figure 4-6. X.25 Configuration Utility Display Flow 

Press the Enter key to move from one display to the next, unless another key is 
specified. 

Help text is availably for all displays in this utility. Simply press the Help key for an 
explanation of the information on the display, available options, and valid 
command keys and their functions. You cannot enter data while viewing a help 
display. 
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Display 1.0 X.25 Configuration Utility Menu 



X.25 CONFIGURATION UTILITY MENU 


1. Select one of the following: 

1. X.25 network and logical channel configuration 

2. X.25 virtual circuit configuration 

Option . 



Cind7-End 




Select one of the following: 

1- X.25 network and logical channel conf^iuration allows you to enter or change 
network and logical channel parameters. If you specify this option, the next display 
you will see is display 1.5. 

2- X.25 virtual circuit configuration allows you to enter or change virtual circuit 
parameters. 
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I Display 1.5 X.25 Network Configuration Menu 


The X.25 Network Configuration Menu (display 1.5) appears when you select 
option 1 from the X.25 Configuration Utility Menu (display 1.0). 


I 1. Select one of the following: allows you to specify whether you are creating, 

I editing, removing, or printing an X.25 network configuration member. 

I 2. Network configuration member name allows you to specify the name for your 

I X.25 network configuration member. 
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Display 2.0 X.25 Network Configuration 

The X.25 Network Configuration display appears when you select option 1 from 
the Main menu. 



1 Network type specifies the type of network support required. Type A supports 
all the standard functions of X.25 and uses modulo 8 sequencing. Type B is 
similar to type A, but uses modulo 128 sequencing. Type C is similar to type 
A, except that it supports the SABM/DISC deviation. Type D is similar to 
type A, except that it supports the remote initiation deviation. The default is 
type A. Refer to Appendix A to determine which network type to specify. 

2 Network default packet size specifies the default packet size that is in the X.2S 
network subscription. You may define the packet as 64, 128, 256, or 512 
bytes. The default is 128 bytes. 

3 Network default packet window specifies the default packet window size that is 
in the network subscription. You may specify the packet window as being 
from 2 through 15 packets, with the CNFIGX25 default being 2. 

4 Link level time-out in seconds specifies the amount of time you want the system 
to wait for a response from the X.25 network. You may specify from 1.0 to 
9.9 seconds. The default is 3.0 seconds. 

5 Local network address specifies the local network address. You may enter up to 
15 decimal digits. The first 4 digits must be the network identification if you 
enter the local network identification with the network address. There is no 
default. 

6 Number of logical channels specifies the number of logical channels in the X.25 
network subscription. The maximum value is 16 and the default is 1. 

7 Maximum packet size allowed by network specifies the maximum packet size 
allowed by the network. The maximum value is 512; the default is 256. 
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Display 3.0 X.25 Logical Channel Configuration 


3.0 


X.25 LOGICAL CHANNEL CONFIGURATION 


Reference number: 

1. Type. S,P 

S-switched P-permanent 

2. Group number.0-F 

3. Channel number.00-FF 

4. Call direction.B,I,0 

B-both I-in only 0-out only 



Cmd3-Previous Display Cmd7-End Cmdl9-Cancel 

L _ J 


Reference numbers are shown in ascending order. If you specify more than eight 
logical channels, press the Enter key to display the remaining logical channels, then 
press command key 3 to return to your first display. 

1 Type specifies the type of logical channel in the X.25 network subscription. 
Enter P for a permanent virtual circuit or S for a switched virtual circuit. The 
default is S. 

2 Group number specifies the group number of each logical channel in the X.25 
network subscription. Enter a hexadecimal number from 0 through F. The 
default is 0. 

3 Channel number specifies the channel number of each logical channel in the 
X.25 network subscription. You can select any hexadecimal number from 00 
through FF. There is no default. 

4 Call direction specifies the direction in which calls can occur on each logical 
channel in the X.25 network subscription. This only applies to switched logical 
channels. You may select I for incoming calls only, B for incoming and 
outgoing calls, or O for outgoing calls only. You should enter a blank for 
permanent logical channels. The default is B. 

Press command key 7 to return to the X.25 Network Configuration Menu (display 
1.5); press command key 3 to return to the previous display; or press command key 
19 to cancel CNFIGX25 and return to the System/3 6 command display. 
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Display 4.0 X.25 Virtual Circuit Menu 


The X.25 Virtual Circuit Menu display appears when you select option 2 from the 
X.25 Configuration Utility Menu (display 1.0). 



x.25 VIRTUAL CIRCUIT MENU 


1. Select one of the following; 

1. Create new member 

2. Edit member 

3. Create new member from existing member 

4. Remove member 

5. Print member 


Option 



Cmd7-End Cmd19-Cancel 




Select one of the following: 

1- Create new member 

2- Edit member allows you to review and change the values in an existing X.25 
virtual circuit configuration member. 

3- Create new member from existing member allows you to use an existing X.25 
virtual circuit configuration member as the basis for a new member. The existing 
member is not changed. 

4- Remove member 

5- Print member 
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Display 5.0 X.25 Virtual Circuit Member Select 



X.25 VIRTUAL CIRCUIT MEMBER SELECT 


1. Member name . 

2. Related RWS or SSP-ICF line member name 

3. Library name. 

4. Existing member name. 

5. Existing member library name. 

6. X.25 network configuration member name 


Cmd7-End Cmdl9-Cancel 






1 Member name specifies the name of the X.25 virtual circuit member on which 
you want to perform the operation. This is retrieved from the related RWS or 
SSP-ICF line member. 

2 Related RWS or SSP-ICF line member name specifies the name of the RWS or 
SSP-ICF configuration member with which these parameters are to be 
associated. 

3 Library name specifies the name of the library in which the member is stored or 
in which the new member is to be stored. This name must match the library 
name you specified during RWS or SSP-ICF configuration. The default is the 
current active user library. 

4 Existing member name appears only if you selected option 3 on the previous 
display. Enter the name of the existing X.25 virtual circuit member from which 
you want to create a new member. The new member will have the same 
configuration parameters as the member you specify here. 

5 Existing member library name appears only if you selected option 3 on the 
previous display. Enter the member library from which you want to copy 
parameters. The default is the current active user library. 

6 X.25 network configuration member name specifies the name of the member in 
which the network configuration parameters are stored. 
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Display 6.0 X.25 Virtual Circuit Configuration 


6.0 X.25 VIRTUAL CIRCUIT CONFIGURATION 

Remote station: **♦♦**♦* Station address: *♦ 

1. Packet size.64,128,256,512 


2. Packet window.2-15 

3. Protocol . A,Q,E,P 

4. Virtual circuit type . SVC,PVC 

5. Tariff totals accumulation . Y,N 

6. Response time tolerance in seconds . 100-999 

Cmd3-Previous Remote Station Cmd7-End Cmdl9-Cancel 





*** 

2 

Q 

SVC 


N 

100 





The X.25 virtual circuit member name appears in the upper right corner of the 
display. Remote station shows either the control unit logical ID that you specified 
in CNFIGSSP for the RWS or the remote system name that you specified in 
CNFIGICF for the line configuration. Station address shows either the control unit 
address that you specified in CNFIGSSP for RWS or the remote or local station 
address that you specified in CNFIGICF for the line configuration. These fields are 
shown for reference only. 

1 Packet size specifies the packet size used with this virtual circuit. You may 
define the packet size as 64,128, 256, or 512 bytes. The default is the default 
packet size you entered during the network configuration section of 
CNFIGX25. This value cannot be larger than the maximum packet size 
allowed by the network as indicated in the network configuration. 

2 Packet window specifies the packet window size you want to use with this 
virtual circuit. Enter a value from 2 through 7 (2 through 15 for network type 
B). The default is the network default packet window you entered during the 
network configuration part of CNFIGX25. 

3 Protocol specifies the end-to-end protocol that you want to use with this 
virtual circuit. Both ends of the link must be using the same protocol. The 
protocol types are: 

P Physical Services Headers (PSH). This logical link protocol uses a 
Physical Services Header to carry logical link control information. The 
PSH protocol has been used in early IBM SNA implementations for X.25. 
You must specify PSH protocol if the remote station is using it. 
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Q Q-bit Logical Link Control (QLLC). This logical link protocol uses the 
qualifier (’Q’) bit in X.25 data packets to identify packets that carry 
logical link control information. This information is required to support 
logical link functions or adjacent node physical services such as exchange 
of identification (XID), mode selection (SNRM/SABM), circuit test 
(TEST), and disconnection (DISC). 

E Enhanced recovery logical link control (ELLC). This logical link protocol 
uses a special header to carry information that permits error recovery and 
resynchronization on an end-to-end or DTE-to-DTE basis. This protocol 
should be used when network reliability is low or when network 
congestion is common. 

A Asynchronous. When an asynchronous subsystem has been selected, the 
system-defined protocol is A. This cannot be changed. 

The default is Q for a non-asynchronous subsystem. 

Note: An increase in packet traffic over P and Q protocols should be expected 
when using the E protocol. This overhead is due to ELLC 
acknowledgements sent in response to incoming ELLC data. 

4 Virtual circuit type specifies the type of virtual circuit you need for this station. 
Enter PVC for permanent virtual circuits or SVC for switched virtual circuits. 

If the associated RWS or SSP-ICF configuration is switched, you must define 
this virtual circuit as an SVC. If the associated RWS or SSP-ICF configuration 
is nonswitched, you can specify either SVC or PVC. 

The default is SVC. 

5 Tariff totals accumulation specifies whether you want tariff totals to be 
accumulated in a file for this virtual circuit. Enter Y (yes) or N (no). If you 
specified Y for any of the stations in this configuration member, an indexed 
file is allocated. The default is N. 

6 Response time tolerance in seconds specifies the amount of time, in seconds, 
that System/36 is to wait for the remote station to respond to a command. 
Valid entries are 100 through 999 seconds, with the default being 100 
seconds. This prompt is not displayed for asynchronous communications 
stations. 

Note: If the parameters you enter do not conform to your network subscription, you 
will receive an error message when you attempt to connect to the network. 

If you select a permanent virtual circuit (PVC), the next display shown is the X.25 

Permanent Virtual Circuit Configuration display (7.0); if you select a switched 

virtual circuit (SVC), the next display shown is the X.25 Switched Virtual Circuit 

Configuration display (8.0). 
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Display 7.0 X.25 Permanent Virtual Circuit Configuration 



7.0 X,25 PERMANENT VIRTUAL CIRCUIT CONFIGURATION 





1. Logical channel reference number 


1-16 


Cmd3-Previous display 



Cmd7-End Cmd19-Cancel 

_ ^ 


This display appears if you selected a permanent virtual circuit (PVC) on the 
Virtual Circuit Configuration display (6.0). The X.25 virtual circuit configuration 
name appears in the upper right corner of this display. 

1 Logical channel reference number: Enter the logical channel reference number. 
This number should match one of the logical channel numbers you entered on 
the Logical Channel Configuration display (3.0). You receive an error 
message if the logical channel reference number you enter has already been 
specified in this configuration or if it is not a permanent virtual circuit. 

Press command key 7 to save the entry and return to the Virtual Circuit Menu 
display (4.0). Press command key 3 to return to the X.25 Virtual Circuit 
Configuration display (6.0). If there are additional remote stations in the RWS or 
SSP-ICF configuration member, press the Enter key to return to display 6.0. Press 
command key 19 to cancel the virtual circuit configuration. No entries are saved. 
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Display 8.0 X.25 Switched Virtual Circuit Configuration 


8.0 


X.25 SWITCHED VIRTUAL CIRCUIT CONFIGURATION 


««*«*««* 


W1 


1. Remote network address . . 

2. Call direction.I/O I 

3. Reverse charge.Y,N N 

4. Connection password.. 

5. Closed user group ID.blank,00-FF 

6. Unique network facilities. 


Cmd3-Previous display Cmd7-End Cmdl9-Cancel 

V 



This display appears only if you selected a switched virtual circuit (SVC) on the 
X.25 Virtual Circuit Configuration display (6.0). The X.25 virtual circuit 
configuration name is displayed in the upper right corner of this display. 

1 Remote network address specifies the remote network address. You can enter 
up to 15 digits. There is no default. If you enter the network identification with 
the network address, the first 4 digits must be the network identification. 

If this virtual circuit configuration is for an asynchronous remote station that 
will be calling you through a PAD, this field can be left blank. 

This parameter is not displayed if the associated SSP-ICF line member is 
switched and if call is specified with an X.25 phone list. When a phone list is 
used, X.25 uses the network addresses in the phone list (as defined by the 
DEFINX25 procedure). 

2 Call direction specifies the call direction to be used in communications between 
this switched virtual circuit and the station you specified for the remote 
network address. This value can be: 

I for incoming call or 

O for outgoing call 

The default is I. 
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If the associated SSP-ICF line member is switched with a switch type of call 
and an X.25 phone list is specified, then the call direction must be O 
(outgoing). If the line is switched with autoanswer, the call direction must be I 
(incoming). If the SSP-ICF line member is configured as being autoanswer at 
ENABLE and call at session initiation, the call direction must be O (outgoing). 

If this virtual circuit configuration is for an asynchronous remote station that 
will be calling you through a PAD, and the remote network address has been 
left blank, the call direction must be I (incoming). 

3 Reverse charge specifies whether reverse charging may be requested on 
outgoing call requests or accepted on incoming call requests. The parameter 
can be Y (yes) or N (no). The default is N. 

4 Connection password specifies the connection password to be exchanged with 
the remote station to establish the virtual circuit. You may enter up to eight 
characters. There is no default. No password validation occurs if you leave 
this field blank. If you enter a password, the password of an incoming call 
request must match this password for a connection to occur. On outgoing 
calls, the password you enter becomes the password of the outgoing call 
request. 

You must enter a password if two switched virtual circuits use two separate 
logical channels to the same station at the same time. The password uniquely 
identifies the stations. 

If this virtual circuit configuration is for an asynchronous remote station, the 
connection password prompt is not displayed. 

This parameter is not displayed if the associated SSP-ICF line member is 
switched with a switch type of call, and an X.25 phone list is specified. When 
a phone list is used, X.25 uses the connection passwords in the X.25 phone list 
(as defined by the DEFINX25 procedure). 

5 Closed user group ID specifies the closed user group for the remote station, if 
one is used. Enter two hexadecimal characters or leave blank. 
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6 Unique network facilities specifies the network specific hexadecimal codes (up 
to 40) you want to insert on an outgoing call request. These codes can be used 
to request facilities such as priority service or a specific throughput class, or to 
select a specific RPOA for international virtual calls. 

You may obtain network facilities and their hexadecimal codes from the 
carrier, 

The hexadecimal codes will be placed directly in the facilities field of the 
appropriate packets. Only syntax checking occurs. It is your responsibility to 
ensure the facilities you request are available. 

You can specify any unique network facilities, with the following exceptions: 

• Packet size 

• Window size 

• Password 

• Closed user group 

• Reverse charge 

You specify these facilities during X.25 configuration using the X.25 
configuration utility. You receive an error message if you define any of these 
in the unique network facilities field. 

Press command key 7 to return to the X.25 Virtual Circuit Menu display (4.0). 
Press command key 3 to return to the Virtual Circuit Configuration display to 
define more logical channels for this member. If there are additional remote 
stations in the RWS or SSP-ICF configuration member, press the Enter key to 
return to display 6.0. Press command key 19 to cancel the virtual circuit 
configuration. No entries are saved. 
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Reconfiguration and Monitoring 


Whenever you change the associated RWS or SSP-ICF line configuration or the 
network configuration, you should run CNFIGX25 and select option 2 on display 
4.0. If you delete a station and then select option 2, CNFIGX25 automatically 
deletes any stations that are configured but no longer in the associated RWS or 
SSP-ICF line member configuration. Similarly, if you add a station and run option 
2, you are prompted for X.25 parameters for the new station. 


Maintenance and Status of X.25 Virtual Circuits 

You can use the X.25 maintenance utility to monitor the status of and change 
certain configuration parameters. You start the utility by entering the MAINTX25 
procedure command, which has no parameters. You are then prompted by a series 
of displays. 

Press the Enter key to move from one display to the next, unless another key is 
specified. 

Help text is available for all displays in this utility. Simply press the Help key for an 
explanation of the information on the display, for available options, and for valid 
command keys and their functions. You cannot enter data while viewing a help 
display. 
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Display 1.0 X.25 Maintenance Utility Menu 



.0 x.25 MAINTENANCE UTILITY MENU 


Select one of the following: 

1. Display the status of the logical channels 

2. Display/Edit the stations waiting for call setup 

3. Display/Edit the active virtual circuit configurations 

4. Display the accumulated tariff totals 

5. Print the accumulated tariff totals and reset 

6. Print the accumulated tariff totals without reset 


Option 


2. Line number 


1,8 



Cmd7-End 


1. Select one of the following: 

1- Display the status of the logical channels displays the logical channels and the 
status of the virtual circuits using the channels on the selected line. Changes 
can then be entered. 

2- Display/Edit the stations waiting for call setup displays the status of all virtual 
circuit configurations on the selected line that are waiting for call setup. These 
virtual circuits are either configured for incoming calls and waiting for a call or 
reconnection, or configured for outgoing calls and waiting for a logical channel 
or network address to become available. The configuration parameters of a 
station can also be edited by selecting this option. 

3- Display/Edit the active virtual circuit configurations displays the status of 
active virtual circuit configuration members on the selected line. An individual 
configuration of the member can be selected and its status displayed. The 
configuration parameters may then be changed. 

4- Display the accumulated tariff totals displays the following accumulated tariff 
totals for each virtual circuit: 

• Number of calls 

• Number of packets sent and received 

• Connect time 

5- Print the accumulated tariff totals and reset prints the accumulated tariff 
totals of a virtual circuit configuration member and resets the totals of that 
member. 
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6-Print the accumulated tariff totals without reset prints the accumulated tariff 
totals of a virtual circuit configuration member without resetting the totals. 

2. Line number specifies the number of the X.25 line on which you want to 
display, edit, or print. 


Display 2.0 X.25 Logical Channel Status 


This display appears if option 1 is selected from the X.25 Maintenance Utility 
Menu (display 1.0). The name of the network configuration appears in the top 
right corner. 


Press command key 7 to return to the Maintenance Utility Menu; press command 
key 15 to update the information on the display; or press command key 19 to 
cancel the logical channel status display. If there are more than seven logical 
channels, use the Roll keys to display additional channels. 


2.0 


X.25 LOGICAL CHANNEL STATUS 


iK * 4i * « « 4i « 

LC 

NUM 

LC 

TYPE STATUS 

CALL REMOTE STATION CONFIG 

DIR STATION ADDR LINE TYPE 

START 

TIME 

PACKETS 

IN 

PACKETS 

OUT 


««« ****««« 




Cmd7-End Cmdl5-Update Cmdl9-Cancel Roll keys-Page 


V _____y 

LC NUM: The logical channel reference number as entered on the X.25 
configuration utility Logical Channel Configuration display. It can be any 
number from 1 through the number of logical channels defined (maximum of 
16). 

LC TYPE: The logical channel type (PVC or SVC) as entered on the Logical 
Channel Configuration display during X.25 configuration (CNFIGX25). 
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STATUS: The X.25 logical channel status. 

• Avail; The logical channel is available for use. 

• Active: The logical channel is active. 

• Unavail: The logical channel is unavailable for use due to an error 
condition. 

CALL DIR: The call direction configured for the virtual circuit on this logical 
channel. 

• In; Incoming call 

• Out: Outgoing call 

REMOTE STATION: The station name associated with the virtual circuit using 
this logical channel. The remote station name is defined in the associated 
SSP-ICF line member or RWS configuration member. 

STATION ADDR: The station address of the virtual circuit using this logical 
channel. The station address is defined in the associated SSP-ICF line member 
or RWS configuration member. 

LINE: The line number of the virtual circuit using this logical channel. 

CONFIG TYPE: The communications support associated with the virtual circuit 
using this logical channel. 

• RWS: SNA Remote Work Station support 

• Peer: SNA Peer support 

. C/SNA: SNUF, SNA MSRJE, APPC, and/or SNA 3270 Device Emulation 

• SFS: SNA Finance support 

• ST TST; SNA Station Test 

START TIME; The time, in hours and minutes, that the virtual circuit was 
opened. 

PACKETS IN: The total number of data packets received since the virtual circuit 
was opened. The value may be up to 9 digits. 

PACKETS OUT: The total number of data packets transmitted since the virtual 
circuit was opened. The value may be up to 9 digits. 
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Dkplay 3.0 X.25 Call Wait Queue Status 


This display is presented when option 2 is selected from the X.25 Maintenance 
Utility Menu (display 1.0). 



This display shows the status of all virtual circuit configurations that are waiting for 
call setup from the line selected on the X.25 Maintenance Menu (display 1.0). 
These virtual circuits are either those configured for incoming calls and waiting for 
an incoming call or reconnection, or those configured for outgoing calls and waiting 
for a logical channel or network address to become available. 

You can edit the configuration parameters for a station by entering the station 
number (1 to 999). Display 6.0, X.25 Virtual Circuit Modification, is then 
presented. If there are more than the six stations, use the Roll keys to display the 
remaining stations. 

REMOTE STATION; The station name associated with the virtual circuit 

configuration. The remote station name is defined in the associated SSP-ICF line 
member or RWS configuration member. 

STATION ADDR: The station address associated with the station as defined in 
the associated SSP-ICF line member or RWS configuration member. 

LINE: The line number of the station. 

MEMBER NAME: The name of the X.25 virtual circuit configuration member 
that is associated with the remote station. 
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CONFIG TYPE: The type of communications support used with the station. 

• RWS: SNA Remote Work Station support 

• Peer: SNA Peer support 

. C/SNA: SNUF, SNA MSRJE, APPC, and/or SNA 3270 Device Emulation 

• SFS: SNA Finance support 
. ST TST: SNA Station Test 

• ASYNC: Asynchronous communications support 
CALL DIR: The call direction chosen for this virtual circuit. 

• In: Incoming call 

• Out: Outgoing call 

WAIT START TIME: The elapsed time, in hours and minutes, since the station 
was enabled or varied online and placed on the call wait queue. 

WAIT CONDITION: The wait condition for SVCs. 

• Call: Waiting for an incoming call. 

• LC: Waiting for a logical channel to become available. 

• Busy: The remote network address called is busy. 

• Reconn: Waiting for reconnection. 
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Display 4.0 X.25 Active Virtual Circuit Configuration Members 

This display is presented if option 3 is selected from the X.25 Mainteitaiice Utility 
Menu (display 1.0) and there are at least two active virtual circuit configurations. 



x.25 


ACTIVE VIRTUAL CIRCUIT CONFIGURATION 



MEMBER CONFIG RWS OR LINE NUMBER OF NUMBER NUMBER ON 

NAME TYPE MEMBER NAME LINE STATIONS ACTIVE WAIT QUEUE 


1 _ Hi m«# :|t lit * * 4t 41 t|t * * * ilc 




tliiK 



Select one of the members for station details . 

Cmd7-End Cmdl5-Update Cmdl9-Cancel Roll keys-Page 



MEMBER NAME: The name of the X.25 Configuration member that is active. 
CONFIG TYPE: The type of communications support used by this member. 

• RWS: SNA Remote Work Station support 

• Peer: SNA Peer support 

. C/SNA: SNUF, SNA MSRJE, APPC, and/or SNA 3270 Device Emulation 

• SFS: SNA Finance support 

• STTST: SNA Station Test 

RWS OR LINE MEMBER NAME: The name of the RWS configuration member 
or the SSP-ICF line member associated with the X.25 configuration member. 

LINE: The line number used by the associated RWS or SSP-ICF configuration. 

NUMBER OF STATIONS: The number of stations within the configuration 
member. 

NUMBER ACTIVE: The number of active (currently using a logical channel) 
stations within that configuration member. 

NUMBER ON WAIT QUEUE: The number of stations waiting for a logical 
channel in this configuration member. 
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Select one of the members for station details: Enter the number of the member 
(one of those displayed under Member Name) for which you wish to see the 
detail. 

If you enter the number of a member name, the display shown is display 5.0, the 
X.25 Virtual Circuit Configuration Status. 


Display 5.0 X.25 Virtual Circuit Configuration Status 


Display 5.0 is presented when you select one of the members on display 4.0. If you 
select option 3 from the X.25 Maintenance Utility Menu, display 5.0 is presented if 
only one virtual circuit configuration member is active. 



5.0 X.25 VIRTUAL CIRCUIT CONFIGURATION STATUS 


REMOTE 

STATION 

VC 

PACKET 

PACKET 

TOTALS 

CALL 

STATION 

ADDR 

TYPE 

SIZE 

WINDOW PROT 

ACCUM 

DIR 

m « « « 


««« 


«« « 





REVERSE CONNECT 
CHARGE STATUS 




Select one of the stations to edit parameters .... 
j Cmd7-End Cmdl5-Update Cmdl9-Cancel Roll keys-Page 

L_ 




The name of the X.25 virtual circuit configuration is shown in the upper right 

corner of the display. 

The following information is displayed on the Virtual Circuit Configuration Status 

display: 

REMOTE STATION: The name of the remote station associated with the virtual 
circuit configuration. This name is defined in the associated RWS or SSP-ICF 
line configuration. 

STATION ADDR: The address associated with the station, as defined in the 
associated RWS or SSP-ICF line configuration. 

VC TYPE: The virtual circuit type (SVC or PVC) as defined using the X.25 
configuration utility. 

PACKET SIZE: The virtual circuit packet size. 

PACKET WINDOW: The virtual circuit packet window size. 

PROT: The protocol that will be used with this virtual circuit. It can be P for PSH, 
E for ELLC, Q for QLLC, A for asynchronous. 
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TOTALS ACCUM: Specifies whether virtual circuit tariff totals are being 
accumulated. 

CALL DIR: The virtual circuit call direction. 

REVERSE CHARGE: Defines whether reverse charge is specified. 

CONNECT STATUS: The station connect status. 

• Disc: Station is disconnected. 

• Req: Request for a connection has been initiated. 

• Wait: Station is on the call wait queue. 

• Clr Rev: Clear recovery in progress. 

• Conn: The connection is established. 

• Rst Rev: Reset recovery in progress. 

• Err: Station is in error state. 

If you want to change any of the configuration values, enter a station number to 
continue with the Virtual Circuit Modification display (6.0). (This number cannot 
exceed the number of remote stations in the virtual circuit configuration.) The 
modification display does not appear if the virtual circuit configuration is not 
active. Changes cannot be made if the remote station is active. 
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Display 6.0 X.25 Virtual Circuit Modification 


This display appears when a station number is entered from the Virtual Circuit 
Configuration Status display (5.0), or when a station number is entered on the Call 
Wait Queue Status display (3.0). 



The name of the X.25 virtual circuit configuration is shown in the upper right 
corner of the display. 

Virtual circuit parameters may be changed using this display. These changes take 
effect the next time the virtual circuit is activated and remain in effect until 
changed by this utility, or until the X.25 link is reenabled. When the X.25 link is 
reenabled, the configuration will be determined by the parameters defined using 
the X.25 configuration utility. 

The remote station and station address are shown for reference only and cannot be 
changed. The remote station field shows the control unit ID that was specified in 
CNFIGSSP for RWS, or the remote station name that was specified in CNFIGICF 
for the line configuration. The station address field shows the control unit address 
that was specified in CNFIGSSP for RWS, or the remote/local station address that 
was specified in CNFIGICF for the line configuration. 

The virtual circuit modification parameters are: 

1 Packet size specifies the packet size used with this virtual circuit. It can be 64, 
128, 256, or 512 bytes. 

2 Packet window specifies the packet window size used with this virtual circuit. 
For network type A or C, it must be from 2 through 7. For network type B, it 
must be from 2 through 15. 
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3 Protocol specifies the link-level end-to-end protocol used with this virtual 
circuit. The protocol types are: 

• P: Physical services headers (PSH) 

• E: Enhanced error recovery logical link control (ELLC) 

• Q: Q-bit logical link control (QLLC) 

• A; Asynchronous 

4 Virtual circuit type specifies the virtual circuit type (SVC or PVC) for this 
station. This parameter is shown only for reference and cannot be changed. 

5 Tariff totals accumulation indicates whether tariff totals are to be accumulated 
for this virtual circuit. It can be Y (yes) or N (no). This value cannot be 
changed from N to Y if the station was originally defined as N when the virtual 
circuit configuration member was created (using the CNFIGX25 procedure). 
Changing from Y to N stops tariff totals accumulation until it is changed back 
to Y by this utility or until the X.25 link is enabled again. 

6 Response-time tolerance in seconds indicates the amount of time within which 
the remote system must respond to a System/36 issued command. Specify 
from 100 through 999 seconds, with the default being 100 seconds. This 
parameter is not displayed for an asynchronous remote station. 

If you are working with a permanent virtual circuit, display 7.0, the X.25 
Permanent Virtual Circuit Modification display, is presented when the Enter key is 
pressed. If you are working with a switched virtual circuit, display 8.0, X.25 
Switched Virtual Circuit Modification display, is presented when the Enter key is 
pressed. 
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Display 7.0 X.25 Permanent Virtual Circuit Modification 


This display is presented after display 6.0 only if you are working with a permanent 
virtual circuit. 




7.0 


X.25 PERMANENT VIRTUAL CIRCUIT MODIFICATION 



1. Logical channel reference number 


1-16 


Cmd3-Previous display 


Cmd7-End Cmdl9-Cancel 




The name of the X.25 virtual circuit configuration is shown in the upper right 
corner of the display. 

1 Logical channel reference number specifies the reference number for the logical 
channel. The logical channel reference number serves as a cross reference 
between this display and the X.25 Logical Channel Configuration display 
(3.0). An error message is issued if the number entered here has already been 
specified in this configuration, if it exceeds the actual number of logical 
channels, or if it is not configured as a PVC. 

The next display shown depends on the path by which you arrived here (at display 
7.0). If you had selected option 3 on the X.25 Maintenance Utility Menu (1.0) 
and then entered a station number on the X.25 Call Wait Queue Status display 
(3.0), display 3.0 is shown again. Otherwise, the X.25 Virtual Circuit 
Configuration Status display (5.0) is shown. 
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Display 8.0 X.25 Switched Virtual Circuit Modification 

This display is presented after display 6.0 only if you are working with a switched 
virtual circuit. 


8.0 


X.25 SWITCHED VIRTUAL CIRCUIT MODIFICATION 




W1 


1. Remote network address . *****•♦***•*•★* 

2. Call direction.1,0 • 

3. Reverse charge.Y,N ♦ 

4. Connection password . . *♦****•• 

5. Closed user group ID.blank,00-FF 

6. Unique network facilities . 


Cmd3-Previous display Cmd7-End Cmdl9-Cancel 




The name of the X.25 virtual circuit configuration is shown in the upper right 
comer of the display. 

1 Remote network address specifies the remote network address. Up to 15 digits 
can be entered. If the network ID is entered with the network address, then 
the first 4 digits must be the network ID. There is no default. 

This prompt is not displayed if the associated SSP-ICF line member is 
switched with a switch type of aiH and an X.25 phone list is specified. When a 
phone list is used, X.25 uses the network addresses in the phone list (as 
defined by the DEFINX25 procedure). 

2 CaD direction specifies the call direction to be used with this SVC. 

• In: Incoming call 

• Out: Outgoing call 

This parameter cannot be changed if the associated SSP-ICF configuration is 
switched. If the line is nonswitched, this parameter can be changed to a new 
call direction only if there is at least one logical channel that supports the new 
call direction. 
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3 Reverse charge specifies whether reverse charging can be used. Reverse 
charging can be used in either of the following two ways: 

• Requesting a reverse charge for an outgoing call 

• Accepting a reverse charge on an incoming request from the specified 
station 

This parameter can be either Y (yes) or N (no). 

4 Connection password specifies the connection password to be exchanged with 
the specified station. Up to 8 characters may be entered. There is no default. 
No password validation occurs if this field is blank. If a password is entered, 
then the password of an incoming call request must match this password or no 
connection is made. On outgoing calls, the password entered here becomes the 
password of the outgoing call request. 

A password must be entered if two switched virtual circuits are to use two 
separate logical channels to the same station at the same time. The password 
identifies the stations. 

This parameter is not displayed if the associated SSP-ICF line member is 
switched with a switch-type call and an X.25 phone list number is specified. 
When a phone list is used, X.25 uses the connection passwords in the X.25 
phone list (as defined by the DEFINX25 procedure). This prompt is not 
displayed for an asynchronous remote station. 

5 Closed user group ID specifies the closed user group for the station. Specify 
two hexadecimal characters or leave blank. 

6 Unique network facilities specifies network hexadecimal codes that may be 
inserted on an outgoing call request. These codes can be used to request 
facilities such as priority service or a specific throughput class, or to select 
specific recognized private operating agencies (RPOA) for international virtual 
calls. Up to 40 hexadecimal bytes may be entered. 

The hexadecimal codes are placed directly in the facilities field of the 
appropriate packets. Only syntax checking is performed. It is the user’s 
responsibility to ensure that the facilities requested are available. 
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Any unique network facilities may be specified with the following exceptions; 

• Packet size 

• Window size 

• Password 

• Closed user group 

• Reverse charge 

The preceding facilities may be specified through the X.25 configuration 
utility. An error message will be issued if any of these are defined in the 
unique network facilities field. 

The next display shown depends on the path by which you arrived here (at display 
8.0). If you had selected option 3 on the X.25 Maintenance Utility Menu (1.0) 
and then entered a station number on the X.2S Call Wait Queue Status display 
(3.0), display 3.0 is shown again. Otherwise, the X.25 Virtual Circuit 
Configuration Status display (5.0) is shown. 
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Display 9.0 X.25 Virtual Circuit Configurations with Tariff Totals 


Display 9.0 is presented when option 4, 5, or 6 is selected on the Maintenance 
Utility Menu (display 1.0). It shows the virtual circuit configuration members for 
which tariff information is being accumulated. When you enter the corresponding 
number for the member, the operation selected on display 1.0 is performed. If 
option 4 was selected on display 1.0, the Virtual Circuits Total (display 10.0) is 
shown. Otherwise, the information is printed and display 9.0 is displayed again. 

X.25 support will accumulate tariff-related totals and store them in a data file. One 
data file is allocated for each X.25 configuration member. A file is automatically 
allocated for each station in a member configured for tariff totals accumulation. 

The following tariff totals are accumulated for each virtual circuit: 

• Number of calls in and out 

• Number of packets sent and received 

• Connect time in and out 



MEMBER NAME: The name of the X.25 virtual circuit configuration member 
associated with a tariff totals accumulation data file. 

RWS OR LINE MEMBER NAME; The SSP-ICF line member or RWS 
configuration member name associated with the X.25 member. 

Enter the number corresponding to the desired member in the lower right corner of 
the display. The number entered must be between 1 and the number of members 
defined (a maximum of 999). The option you selected on the X.25 Maintenance 
Utility Menu (display 1.0) is then performed. 
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Display 10.0 X.25 Virtual Circuit Totals 


This display is presented when option 4 (Display the accumulated tariff totals) is 
selected on the Maintenance Utility Menu (display 1.0) and a member is selected 
on the X.25 Virtual Circuit Configurations with Tariff Totals display (display 9.0). 



10.0 


x.25 VIRTUAL CIRCUIT TOTALS 


Last Reset-**/**/** 


W1 


REMOTE STATION IN 


OUT 


IN TIME OUT TIME PACKETS 


STATION ADDR CALLS CALLS CONNECTED CONNECTED 


IN 


packets 

OUT 






Cmd7-End Cmd19-Cancel 


Roll keys-Page 


V, 



REMOTE STATION: The station name associated with the virtual circuit. 

STATION ADDR; The station address associated with the station. 

CALLS IN: The number of incoming calls made on the virtual circuit. Does not 
apply to PVCs. 

CALLS OUT: The number of outgoing calls made on the virtual circuit. Does not 
apply to PVCs. 

IN TIME CONNECTED: The amount of time (in hours and minutes) that the 
virtual circuit was active for incoming calls. Does not apply to PVCs. 

OUT TIME CONNECTED: The length of time (in hours and minutes) that the 
virtual circuit was active for outgoing calls. Does not apply to PVCs. 

PACKETS IN: The total number of data packets received (up to 99999999) when 
the virtual circuit was active. 

PACKETS OUT: The total number of data packets transmitted (up to 99999999) 
when the virtual circuit was active. 

Press command key 7 to return to the X.25 Virtual Circuit Configurations with 

Tariff Totals display (9.0). 
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I Chapters. Defining Lists for BSCEL, Autocall, X.21, X.25, and 
I Asynchronous Communications 


The procedures described in this chapter are used to define the lists needed by 
System/36 in certain communications environments. For example, when autocall 
is used, it needs a list of the telephone numbers to call; X.25 uses a list of network 
addresses. The procedures defined in this chapter are: 

. Defining remote IDs for SSP-ICF BSCEL (DEFINEID) 

• Define phone number list for autocall (DEFINEPN) 

• Define X.21 public data network connection numbers or X.21 short hold mode 
line configuration information (DEFINX21) 

. Define network address for X.25 (DEFINX25) 

The uses of the lists by the communications features are described in the following 
System/36 manuals: 

. SSP-ICF Reference 

. MSRJE Guide 

• 3270 Guide 

. C&SM Guide 

• Programming with RPG II 

• Programming with Assembler 


DEFINEED Procedure 


The DEFINEID procedure is used to specify a list of the remote IDs for a switched 
communication line using the SSP-ICF BSCEL subsystem. When the System/36 
using BSCEL is connected to a remote system by a switched communications line, 
this list is examined for a comparison with the ID received from the remote system. 
This list is only examined when multiple remote switched line IDs were specified 
when the subsystem was configured. If the ID is found, line initiahzation completes 
successfully. If it is not found, the remote system is disconnected. 
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The DEFINEID procedure runs the $IDSET utility program. The DEFINEID 
procedure creates a system file named #IBSRID, which is four sectors long and can 
contain up to 55 remote IDs. 

The DEFINEID procedure can be run from any command-capable display station. 

For the BSCEL subsystem to use the remote IDs defined by the DEFINEID 
procedure, the multiple remote IDs option must be selected when you configure the 
BSCEL subsystem using the CNFIGICF procedure. The DEFINEID procedure is 
called automatically by the CNFIGICF procedure when the multiple remote ID 
option is selected. See the manual SSP-ICF Reference for information on defining 
a BSCEL subsystem using CNFIGICF. 

If the subsystem has already been enabled, and you want to change the list of 
remote IDs: 


1. Disable the BSCEL subsystem using the DISABLE procedure. 

2. Change the remote ID file (#IBSRID) using the DEFINEID procedure. 

3. Enable the BSCEL subsystem using the ENABLE procedure. 

You should run the DEFINEID procedure before the BSCEL subsystem requiring 
remote IDs is enabled. Following is the DEFINEID procedure prompt display and 
an explanation of the parameters: 


DEFINEID PROCEDURE 

Creates, updates, displays or deletes the list of 
remote IDs for a switched communication line using 
the SSP-ICF BSCEL subsystem 

Remote ID option . DISPLAY,DELETE,UPDATE DISPLAY 


^^Cmd3-Previous menu 
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Remote ID option specifies if the remote ID should be displayed, deleted, or 
updated. 

7 specifies that the remote IDs are to be displayed. The remote IDs 
cannot be modified. This parameter is valid only if remote IDs are defined. 

DELETE specifies that the entire list of remote IDs (file #IBSRID) is to be 
deleted from disk. This parameter is valid only if remote IDs are defined. 

UPDATE specifies either that the list of remote IDs is to be created, or that the 
existing list of remote IDs is to be changed. 


Example 


This example (using the DEFINEID procedure command) shows how to create or 
update the remote ID list. 

DEFINEID UPDATE 

Refer to Appendix D for the format of this command. 

After you enter the procedure command, you see the DEFINEID display on which 
you can add or update BSC switched line remote identification definitions. 


DEFINEID Display Description 

The DEFINEID display (shown in Figure 5-1) allows you to enter an initial remote 
ID list or to update the existing IDs. You can add, delete, activate, or deactivate the 
remote IDs. When the DEFINEID procedure ends, all deleted remote IDs are 
removed from the file and the file is condensed. 



BSC SWITCHED LINE REMOTE IDENTIFICATION DEFINITION 


STATUS REMOTE ID, hexadecimal 


STATUS REMOTE ID, hexadecimal 


1 


2 


3 


4 


5 6 

7 8 

9 10 


11 . 12 . 

13 . 14 . 

15 . 16 . 

Cmd7-End Cmdl9-End without update Roll keys-Page 

V_ 






F^e 5-1. DEFINEID Entry Display 
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The columns for the display shown in Figure 5-1 are defined as follows: 

Status specifies the status for the remote ID. Valid entries are D, I, R, or a blank. 

D indicates that the remote ID should be deleted from the remote ID list. 

I indicates that the remote ID is to be deactivated, that is, the ID is not included 
in the compare operation but remains in the remote ID list. 

R indicates that the remote ID is to be reactivated, that is, after the code was 
deactivated (I), the remote ID is again to be included in the compare operation. 

If the status field is left blank, the remote ID is added to or updated in the list. 

Remote ID specifies the ID of the remote station in hexadecimal. 

The display functions are specified by the following keys: 

Function 

Page forward 

Page forward 

Page back 

End the DEFINEID procedure 

End the DEFINEID procedure but do not place any 
changes made in the file containing the remote IDs 
(named #IBSRID) 

Display additional information 


Key 

Enter 

Roll Up 

Roll Down 

Command key 7 

Command key 19 

Help 
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DEFBVEPN Procedure 


The DEFIMEPN procedure provides a way to create or update a phone list for the 
autocall feature. Each phone list can contain up to 105 phone numbers. The phone 
lists are created by the DEFINEPN procedure and are used by the autocall feature. 
The generated phone lists are placed in load members. Refer to the following 
manuals for information on how the phone list can be used: 

• SSP-ICF Reference 

• MSRJE Guide 

. C&SM Guide 

• 3270 Guide 

• Programming with RPG 11 

• Programming with Assembler 

• SSP-ICF Guide and Examples 

When the DEFINEPN procedure begins, you can either create a new phone list or 
change an existing phone list. You can then enter the name of the phone list, the 
name of the library to contain the phone list, and the mode of operation (either 
delay or nodelay). 

Note: DELA Y must be specified for systems in all countries except the United States 
and Canada. If DELAY is specified, the autocall feature will process the 
phone list in the following manner: 

• 60 seconds pass before the first call is placed 

• 60 seconds pass before a return call is placed to a member that was 
previously called unsuccessfully 

• 3 seconds pass between each attempted call to a number not previously 
called 

If NODELA Y is specified, there is no delay between calls when the phone list 
is processed. 

The member must be in the same library as the CNFIGICF configuration member. 
After the phone list and library names are entered, another display is shown that 
allows you to enter or change the phone numbers. 

The DEFINEPN procedure runs the $PNLM utility program. 
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Example 


To create a phone list named PHONELST, which is to be placed in the library 
named COMMLIBR, you would enter the following: 

DEFINEPN 
You would then: 

1. On the first display, select the option to build the phone list. 

2. On the second display, enter the name of the phone list (PHONELST), the 
library name (COMMLIBR), and the mode of operation (either DELAY or 
NODELAY). The library name may already be filled in if you previously 
specified a session library. 

• 3. On the third display (Figure 5-2), enter the phone numbers, retry values, and 
delay values. 

DEFINEPN Display Description 

Figure 5-2 shows the display that is shown when you create a list; the display for 
changing the list is similar. 



Build a phone list 

Phone number Retry value Delay value 

1-22 digits,I,D 1-255 3-126 

5551234. 002 003 


Roll Keys-Paging Cmd3-Previous display Cmd7-End 




F^ure 5-2. DEFINEPN Phone List Display 
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The following information should be specified for each phone number in the phone 

list: 

Phone number including separator and end of number characters, if used. The 
phone number can be 1 to 22 characters in length with any number of separator 
characters and one end of number character included. Allowable characters are 
apostrophes (’), asterisks (*), and the digits 0 through 9. Other characters that 
can be entered are: plus signs (+), colons (:), commas (,), and question marks 
(?). These other characters currently have no use or definition. 

An apostrophe (’) represents a separator character. This character is used to 
make the autocall feature wait for a dial tone before continuing with the rest of 
the numbers to be called. For example, in many businesses you must dial 9 
before you get a phone line outside your business. You might place a separator 
character after the 9 to make the autocall feature wait for the dial tone that 
occurs after the 9 is dialed. Check with your common carrier (a company that 
provides communications services) to see whether you need separator characters 
in your phone lists. 

An asterisk (*) represents the end-of-number character. If included, it must be 
the last character of the phone number. For a description of how to configure 
your system for the separator and end-of-number characters, see the 
“SETCOMM Procedure” in Chapter 2. 

The end-of-number character is used by only a few modems, and causes the 
data-set-ready condition immediately on those modems. For this reason, you 
should check with your modem supplier to determine whether your modem 
requires end-of-number characters. 

I in the leftmost position of the field inserts an entry after the current entry. An 
I is not allowed if the list has fewer than two entries, if it is the last entry of the 
list, or if the maximum number of entries in the list has been reached. Only one 
entry can be inserted at a time. 

D in the leftmost position of the field deletes an entry. You can delete more 
than one entry at a time. 

Retry value specifies the total number of times an attempt should be made to call 
this number. Allowable values are 001 to 255. If no retry count is specified, a 
value of 001 is assumed. The value you enter must be three digits long and 
right-justified; that is, if you want a value of 5, you must enter 005. Note that 
you can enter a 5 and press the Field Exit key to right-justify the value (you will 
see 005). 

Delay value indicates the time to wait for the remote system to be connected after 
the last digit has been dialed. Allowable values are 003 to 126 seconds. If no 
value is specified, 20 seconds are assumed. The timer value must be 
right-justified; that is, if you want a value of 5, you must enter 005. Note that 
you can enter a 5 and press the Field Exit key to right-justify the value (you will 
see 005). 

Note: Depending on the modems and the communications programs used, 3 

seconds may not be enough time for the remote system to be connected. It 
is suggested that this value be 24 seconds or greater. 
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DEFINX21 Procedure 


The DEFINX21 procedure provides a way to create or update a list of public data 
network connection numbers for the X.21 switched feature; or to create, update, 
print, or remove an X.21 short hold mode (SHM) line configuration. 

The DEFINX21 procedure runs the $XNLM utility program or the $XNSH utility 
program. 

Following is a copy of the DEFINX21 procedure prompt and an explanation of the 
parameter: 


DEFINX21 PROCEDURE 

Creates or updates a short hold mode line configuration 
or the lists of connection numbers for the X.21 feature. 

Short hold mode.NONSHM,SHM NONSHM 


Optional-* 


CmdS-Previous menu 



COPR IBM Corp. 1985^ 


Figure 5-3. DEFINX21 Procedure List Display 

Short hold mode specifies whether you are working with an X.21 short hold mode 
line. Short hold mode can help reduce line usage on X.21 circuit switched lines. 
See Appendix H, “X.21 Short Hold Mode” for more information on short hold 
mode. 

NONSHM creates or updates the lists of X.21 public data network connection 
numbers. NONSHM is the default. If you use the default, the next display you 
use will be the DEFINX21 Connection List display. 

SHM creates, updates, prints, or removes an X.21 short hold mode line 
configuration. If you specify SHM, the next display you will use is the Define 
X.21 Short Hold Mode Option menu. On this display you can specify the option 
you want. 
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( Define an X.21 Connection List 


I Example 


Each connection list can contain one to 7 5 connection numbers. The lists are 
created by the DEFINX21 procedure and are stored as library load members. 

Refer to the following manuals for information on how this list can be used: 

• SSP-ICF Reference 

• MSRJE Guide 

. 3270 Guide 

• C & SM Guide 

• Programming with RPG II 

• Programming with Assembler 

When the DEFINX21 procedure begins, you can choose either to create a new list 
or to change an existing list. You can then enter the name of the list and the name 
of the library to contain the list. The member must be in the same library as the 
CNFIGICF configuration member. After the list and library names are entered, a 
display allows you to enter, change, or delete the connection numbers and the retry 
values and delay values for the numbers. 


This example shows how to create an X.21 connection list named PHONEX21. 
Enter: 

DEFINX21 NONSHM 

You would then perform the following: 

1. On the first display, select the option to create the connection list. 

2. On the second display, enter the connection list name (PHONEX21), and the 
library name where the connection list should be stored. 

3. On the third display (Figure 5.4), enter the connection numbers, retry values, 
and delay values for the phone list. 
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I DEFINX21 Connection List Display Description 


Figure 5-3 shows the display that appears when you create a list; the display for 
changing the list is similar. 



I Figure 5-4. DEFINX21 Connection Ust Display 

I The following information can be specified for each connection number in the 

I phone list: 

I Connection number specifies the number to be dialed. The number can be from one 

I to 18 characters. The allowed characters are 0 through 9, hyphens (-), periods 

I (.), commas (,), and slashes (/). The actual characters you enter are determined 

I by your network. 

I You can also enter DC, I, or D. 

I DC specifies direct call. Direct call is a facility of the X.21 network. 

I I specifies that you want to insert a number. An I in the leftmost position of the 

I field inserts a number after the current number. An I is not allowed if the list 

I has fewer than two numbers, if it is the last number on the list, or if the 

I maximum number of entries in the list has been reached. Only one number can 

I be inserted at a time. 

I D specifies that you want to delete a number. You can delete more than one 

I entry at a time. 
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I Retry value specifies the total number of times an attempt should be made to call 

I this number. 

I Allowed values are 001 to 255. If no retry count is specified, a value of 001 is 

I assumed. The error retry count value must be three digits long and 

I right-justified; that is, if you want an error retry count of 5, you should enter 

I 005. You can enter a 5 and press the Field Exit key to right-justify the value 

j (you will see 005). 

I Delay value indicates the minimum time to wait before attempting a retry to a 

I number that could not be reached. Allowed values are 0 to 16 seconds. If no 

I value is specified, 00 seconds are assumed. The delay value must also be 

I right-justified. 

I Define an X.21 Short Hold Mode Line Configuration 

1 Only one X.21 short hold mode configuration per line can be defined. The line 

I configurations are stored as a load member in the library #X21LIB. If this library 

1 is not already on your system, it will be built by the DEFINX21 procedure. 

I When the DEFINX21 procedure begins, you can select either to create a new X.21 

1 SHM line configuration or to update, print, or remove an existing X.21 SHM line 

I configuration. You can then enter the line number of the new or existing 

I configuration. If you chose to create or update a configuration, a display will allow 

I you to enter or change the X.21 SHM line configuration values. 


I Example 


I This example shows how to create an X.21 SHM configuration for line 1. Enter: 

1 DEFINX21 SHM 

I You would then do the following: 

I 1. On the first display, select the option to create an X.21 SHM line 

I configuration. 

1 2. On the second display, enter the line number (1). 

1 3. On the third display (Figure 5.5), enter the X.21 SHM configuration values for 

I the line. 
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I DEFINX21 Short Hold Mode Line Configuration Display 


The following display appears when you create an X.21 Short Hold Mode line 
configuration. The display for updating an X.21 SHM line configuration is similar. 



I Figure 5-5. Create an X.21 Short Hold Mode Line Configuration Display 

I Local phone number specifies the phone number of the local system. One to 18 

I characters can be entered. The actual number of characters that can be entered 

I and the separator characters that may be used are determined by your network. 

I Retry value specifies the number of times an attempt should be made to establish 

I communications with a remote system; one to 255 attempts can be made. An 

I error condition is indicated if the connection cannot be established. 

I Delay value in seconds specifies the minimum time (one to 16 seconds) to wait after 

I a call has failed before attempting to retry a call to a remote system. 

I Disconnect timer value in seconds specifies the minimum amount of time that the 

I system should stay connected with the specified station before entering the short 

I hold mode disconnected state. From 1.0 to 60.0 seconds can be entered in 

I multiples of 0.5. 

I Inactivity timer value in minutes specifies the time interval after which the primary 

I station should call and poll each specified station to verify that it is still available. 

I One through 60 minute intervals are allowed. You can specify D to disable the 

I inactivity timer. 

I Note: The disconnect inactivity timer values configured here are only used when 

I the local station is the primary station on the line. 
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Local XID node ID specifies five hexadecimal characters (0 through 9, A through 
F) for the local XID node ID. The local XID node ID identifies your local 
device (your chosen value is used by the SDLC XID command). 

Direct call? specifies whether the X.21 direct call facility should be used to call a 
remote system. Direct call is a facility of the X.21 network. 

Nordic network and host has group number facility? specifies whether you are on the 
Nordic network; the host has multiple lines at the same address (group number 
facility). This prompt applies only if you are using Upline, MSRJE, or 3270 
Device Emulation. 
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DEFINX25 Procedure 


You define an X.25 phone list or an asynchronous PAD phone list by entering the 
DEFINX25 procedure command. A phone list selection display is then shown on 
which you can specify the type of phone list you wish to work with (X.25 or 
Async). After you make this selection, a menu that allows you to specify whether 
you want to create, change, remove, or print a list of network addresses is 
presented. 

If you are creating or changing a list of network addresses, additional displays are 
then presented. 

Following is the X.25 Define Phone List Selection display and an explanation of 
the parameters; 


0.5 


X.25 DEFINE PHONE LIST SELECTION 


Select one of the following: 

1. Work with X.25 phone lists 

2. Work with Async PAD phone lists 


Option 



Cmd7-End 



COPR IBM Corp. 1986 

J 


Select one of the following: 

1- Work with X.25 phone lists If you specify that you want to work with X.25 phone 
lists, the next display is display 1.0, on which you can create, change, remove or 
print an X.25 phone list. 

2- Work with Async PAD phone lists If you specify that you want to work with 
asynchronous communications phone lists, the next display is display 1.0, on which 
you can create, change, remove or print an Async phone list. 
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For an X.25 Phone List 


These network addresses are successively tried on outgoing call requests. If a 
successful connection is made, a virtual circuit is established. If all network 
addresses and retry values are exhausted, then a message will be displayed. 

For incoming calls, when autoanswer is specified in the line configuration, the 
network address supplied by the calling station is compared to the addresses in this 
phone list. If a match is found, the virtual circuit is established. If no match is 
found, the call request is rejected. 

Note: To use a phone list to verify incoming call requests for an SSP-ICF 

subsystem, you must: 

1. Specify autoanswer (option 2) for the Switch type at ENABLE prompt on 
display 12.0, SNA Line Member Attributes, when defining the SNA/X.25 
line member using CNFIGICF. 

2. Specify call (option 1) for the Switch type for session initiation prompt and 
specify an X.25 phone list name for the Phone list name prompt on display 
12.0, Remote System Attributes, when defining an SNA/X.25 line 
member with CNFIGICF. 

3. Specify outgoing (O) for the Call dira:tion prompt on display 3.0, Logical 
Channel Configuration, during X.25 logical channel definition using 
CNFIGX25. 


On the following display, you can specify whether you want to create, change, 
remove, or print an X.25 phone list. 


1.0 


X,25 DEFINE PHONE LIST MENU 


W1 


Select one of the following: 

1. Create an X.25 phone list 

2. Change an X.25 phone list 

3. Remove an X.25 phone list 

4. Print an X.25 phone list 

Option . 


Cmd7-End Cmdl9-Cancel 


If you had selected option 2 on display 0.5, you would also see display 1.0. In this 
case, the options would specify creating, changing, removing, or printing an 
asynchronous PAD phone list. 
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I For an Asynchronous PAD Phone List 

I These phone list numbers are used with the rotary dial function of the 

I asynchronous communications subsystem. When using this function, the subsystem 

I successively tries to connect to the phone numbers in the list. When the subsystem 

I gets a busy signal or associated message back from the network, the next number is 

I the list is tried. 

Dii^lay 2.0 X.25 Phone List Member Selection 

I The second line of the heading indicates the operation to be performed (create, 

I change, remove, or print from display 1.0) and the type of list (X.25 phone list or 

I asynchronous communications PAD phone list from the phone list selection display 

I 0.5). 



I 1 Phone list name specifies the name of the phone list. For an X.25 phone list, 

this name must be inserted into the associated SSP-ICF configuration phone 
list name field. There is no default. 

I 2 Phone list library name specifies the name of the library containing the phone 

1 list. For an X.25 phone list or for an asynchronous communications PAD 

phone list, the library name must be the same as the corresponding SSP-ICF 
line member library name. The default for this prompt is the current active 
user library. 

3 Associated remote system name specifies, when when using the CREATE 
option, the name of the remote system in the SSP-ICF line member with 
which this list is to be associated. When using the CREATE option, the 
associated remote system name will be displayed by the utility after the first 
I two prompts have been entered and the Enter key has been pressed. This 

I prompt is not displayed for PRINT and REMOVE or for any operation on an 

1 asynchronous conununications PAD phone list. 
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Display 3.0 X.25 Define Phone List 


The second line of the display indicates the operation, create or change from 
display 1.0, and the type of phone list, X.25 or asynchronous from display 0.5. 



x.25 Define Phone List 
Create X.25 Phone List 


NETWORK ADDRESS PASSWORD 

1-15 Digits,I,D 


Cmd7-End Cmdl9-Cancel Enter-Update Roll-Page 



W1 


RETRY VALUE 
1-255 


Network address specifies the remote network address of the station to be called. 

Up to 15 digits can be entered. If the network ID is entered with the network 
address, then the ID must be the first 4 digits entered. There is no default. 

Entering an I in the leftmost position allows you to insert a new entry in the 
phone list after the current entry. An insert is not allowed if the Ust has one or 
no entries, if the current entry is the last entry in the list, or if the list already 
contains the maximum number of entries. Only one insert can be performed at a 
time. 

You can also enter a D in the leftmost position to delete the current entry in the 
list. More than one entry can be deleted. 

Password specifies the connection password to be exchanged with the remote 
station. Up to 8 characters may be entered. The password must match the 
password of the remote station. Otherwise, the connection will not be 
established. There is no default. 

Passwords cannot be entered for an asynchronous communications PAD phone 
list. 

Retry value specifies the number of times that an attempt will be made to call the 
specified remote station. 

Press the Enter key to update the phone list or press command key 7 to return to 
the Phone List Main Menu display (1.0). 
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Chapter 6. Starting and Stopping Communications Subsystems 


Starting a Subsystem (ENABLE Procedure) 

The ENABLE procedure starts or enables an Interactive Communications Feature 
(SSP-ICF) subsystem, MSRJE, or 3270 Device Emulation. The ENABLE 
procedure must be run before a subsystem can be used. See one of the following 
manuals for more information: 

• For information about SSP-ICF, see the manual SSP-ICF Reference. 

I • For information about asynchronous communications support, see the manual 

I Using the Asynchronous Communications Support. 

• For information about MSRJE, see the manual MSRJE Guide. 

• For information about 3270 device emulation, see the manual 32 70 Guide. 

This procedure can be run at any display station, but only one ENABLE procedure 
can be run at a time. 

The ENABLE procedure runs the $IENBL utility program. Following is the 
ENABLE procedure prompt display and an explanation of the parameters: 
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Subsystem configuration name specifies the subsystem configuration to be enabled. 
This is the name that was specified when the CNFIGICF procedure was run to 
configure the subsystem member. 

Name of library specifies the library containing the subsystem configuration. If no 
library name is specified, the current library is assumed. 

Line number specifies the number of the communications line to use for the 
subsystem. You can specify any number from 1 through 8. If you are enabling 
the Intra subsystem, you must omit this parameter. If the subsystem has been 
previously enabled, and you are enabling another remote location for that 
subsystem, this parameter is optional. 

Display values in effect for this subsystem specifies whether the display values 
configured for the subsystem are to be displayed. Allowed entries are: 

NOSHOW specifies that the parameters configured for a particular subsystem 
are not to be displayed. If no parameter is specified, NOSHOW is assumed. 

SHOW specifies that all the parameters configured for a particular subsystem 
are to be displayed. You cannot change any of these parameters. For a 
description of the parameters that are displayed, see one of the manuals 
mentioned above. 

Remote location name specifies the location to be activated. The location is 
activated if it is not already enabled. 


Example 


In the following example, the ENABLE procedure command enables the subsystem 
specified by the configuration member SUBl found in the library named MYLIB. 
SUBl is to use communications line 1, and the parameters for this configuration 
are to be displayed. All locations for which Y (yes) was specified on the Activate 
location at ENABLE prompt during CNFIGICF are enabled. 

ENABLE SUB1,MYLIB,1,SHOW 

Refer to Appendix D for the format of this command. 
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Stopping a Subsystem (DISABLE Procedure) 


The DISABLE procedure stops or disables an enabled Interactive Communications 
Feature (SSP-ICF) subsystem, MSRJE, or 3270 Device Emulation. See one of the 
following manuals for more information: 

• For information about SSP-ICF, see the manual SSP-ICF Reference. 

I • For information about asynchronous communications support, see the manual 

1 Using the Asynchronous Communications Support. 

• For information about MSRJE, see the manual MSRJE Guide. 

• For information about 3270 Device Emulation, see the manual 3270 Guide. 

The DISABLE procedure can be run from any display station, but from only one 
display station at a time. 

If there are active communication sessions, DISABLE displays a message with the 
following options: 

0 Hold the disable; no new sessions are to start. The system will continue the 
disable when the current communication sessions end. 

1 Retry the disable and check again for active sessions. 

2 Immediately end the active sessions and continue the disable. 

3 End the DISABLE procedure and ignore the disable request. The DISABLE 
procedure is canceled, and the subsystem remains enabled. 

The DISABLE procedure runs the $IEDS utility program. 
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Following is a copy of the DISABLE procedure prompt display and an explanation 
of the parameters: 


DISABLE PROCEDURE 
Disables an enabled subsystem 


Subsystem configuration name 
Name of location to be ended 


Optional-* 


Cmd3-Previous menu 



(c) 1983 IBM Corp.^ 


Subsystem configuration name specifies the subsystem configuration to be disabled. 

Name of location to be ended specifies the remote location to be disabled. The 
subsystem remains enabled as long as there are other active locations. If the 
location name is not specified, all remote locations will be disabled. 


Example 


This example, using the DISABLE procedure command, shows how to disable the 
subsystem configuration SUBl. 

DISABLE SUBl 

Refer to Appendix D for the format of this command. 
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Chapter 7. Problem Determination and Link Verification 


ICFDEBUG Procedure 

The ICFDEBUG procedure controls the running of the Interactive 
Communications Feature (SSP-ICF) debug program. After the debug file is 
displayed or printed, the file is deleted. 

The SSP-ICF debug procedure (ICFDEBUG) allows you to save information on 
disk about each SSP-ICF operation while your program(s) is running. You can then 
display or print the information to help you find the cause of an SSP-ICF problem. 
Information is saved for all SSP-ICF operations in all application programs that are 
running. 

To use the procedure, enter the ICFDEBUG procedure command. You also enter a 
parameter with the command to activate or deactivate the debug trace, or to 
specify whether you want the debug information displayed or printed. When you 
run the ICFDEBUG procedure, any information saved previously is deleted. 

The following is the prompt display for the ICFDEBUG procedure and a 
description of each parameter: 
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ICF debug function entries allowed for this field are: 

ON specifies that the debug program is to be started. The program begins 
recording SSP-ICF activities in a disk file. Any previous file created by the 
ICFDEBUG procedure is deleted. 

OFF specifies that the debug program is to be stopped. No further SSP-ICF 
activity is to be recorded and the disk file created by the ICFDEBUG 
procedure is deleted. 

C/?r specifies that the file previously created by the ICFDEBUG procedure is 
to be displayed. 

PRINT specifies that the file previously created by the ICFDEBUG procedure 
is to be printed. 

Name of job for which entries are to be listed specifies that entries for the named job 
are to be printed from the file previously created by the ICFDEBUG procedure. 
You can use the STATUS USERS control command to display the job names. 

The following two examples use the ICFDEBUG procedure command. Refer to 
Appendix D for the format of this command. 


Example 1 


This example shows how to start the SSP-ICF debug program. 
ICFDEBUG ON 


Example 2 


This example shows how to print the activity recorded after the procedure 
command ICFDEBUG ON was entered. 

ICFDEBUG PRINT 

About the Infonnation Saved 

The debug information is saved in a file created by System/36 when you use the 
debug procedure. The file is deleted when you start or stop the debug procedure or 
when you display or print the information in the file. 

Up to 512 entries can be stored in the file. If the file becomes full, any further 
entries are written over the oldest entries in the file. Therefore, the file always 
contains the 512 most recent SSP-ICF operations. The entries are displayed in the 
order in which they were stored (oldest to newest). And, the entries may not be in 
the order in which they were issued by the application program. The entries are in 
the same order that the return codes were issued by SSP-ICF data management. 
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Description of ICFDEBUG Output 


The following examples show the format of the ICFDEBUG procedure output. 
Following these examples is a description of this information. 


D 

B 

a 

0 

B 

B 

B 

B 

B 

IB 

JOB NAME 

PROC name: 

PROG NAME 

I..DC NAME 

FORMAT NAME 

SYM n:i 

MAJ/MIN 

OPERAT ION Cl 

DDE DATA LEINGTH 

DATA •••• 

wail1447 

ITEMAK-PCJ 

ITEMAR 

INTRA 


IS/ 

OOOO 

ACiCT 



wail1447 

IIEMARPO 

ITEMAR 

INIRA 

itHiEOOK 

18/ 

0001 

EOI 

0023 

0000000000000000 

0aill4S3 

ITEMBRPG 

ITEMBR 

INTRA 


oa/is 

OlOO 

AC I 

0023 

oooooooooooooooo 

0aill4K3 

ITEMBRPO 

ITEMBR 

:tNrRA 

$$SEND 

02/18 

0001 

PTI 

0224 


Waill447 

ITtiMARPG 

ITEMAR 

INTRA 


18/02 

OOOO 

GET' 

0224 


wail1447 

ITEMARPG 

ITEMAR 

INTRA 

$$SENi:iET 

18/ 

OOOO 

PEX 

OOOO 


0aill4S3 

IfEMBRPG 

ITEMBR 

INTRA 


02/ 

0308 

AC I 

OOOO 


wail1447 

ITEMARI^-G 

ITEMAR 



18 

OOOO 

Rt;:i... 




Q JOB NAME is the name of the job associated with this entry. 


Q PROC NAME is the name of the procedure associated with this entry. 

01 PROG NAME is the name of the program which issued the operation in this 
entry. 

Q LOC NAME is the location name specified in the SESSION statement and 
configuration member. 

B FORMAT NAME is the name of the $$ operation issued by a BASIC, 
COBOL, or RPGII program. If APPC or INTRA is being used, this could 
also be the IDDU format name issued. 

□ SYM ID is the symbolic identifier for this session. If this is shown for a DDM 
source program, this field will be blank. If this is the Intra subsystem, the 
symbolic identifier for both programs is displayed or printed as shown in the 
following example: 

1S/01 
1 1 

1 The session identifier for the 
I program started by the evoke 
1 operation (assigned by SSP-ICF). 

I 

The session identifier for the 

program that issued the acquire 

operation (specified in the SESSION statement). 

Q MAJ/MIN are the major and minor portions of the return code issued for this 
operation. See the appropriate subsystem chapter in the SSP-ICF Reference 
manual for a description of the return code. 

B OPERATION CODE is the assembler operation code. See the assembler 
chapter in the SSP-ICF Reference manual for the meaning of this code. 

B DATA LENGTH is the length of the data record sent or received for this 
operation, if any. 


HjI DATA is the first 16 characters of the data sent or received, if any. 
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STARTM Procedure 


The STARTM procedure starts automatic monitoring of a BSC multipoint line. The 
System/36 responds to all host polls or selects on a BSC multipoint line with a 
negative acknowledgement. A nonswappable BSC interrupt handler is not required 
in main storage for the automatic monitoring function. Therefore, the System/36 
can be placed in the host’s polling list without any tasks in the System/36 being 
started until necessary. 

Automatic monitoring continues until stopped by the STOPM procedure, or until a 
batch BSC job is started, BSC MSRJE is enabled, or an SSP-ICF BSC subsystem is 
enabled on that line. 

The STARTM procedure runs the $MMST utility program. 

Following is the procedure prompt display for STARTM and a description of the 
parameters. 



Communications line number specifies the line number that is placed in automatic 
monitor mode. You can enter a number from 1 through 8. This line must be a 
multipoint hne. 

ASCII or EBCDIC transmission code specifies the type of transmission code to be 
used. Allowed entries are: 

E specifies that the transmission code is EBCDIC. 

A specifies that the transmission code is ASCII. 

Two-character hexadecimal multipoint station address specifies the 2-character 
hexadecimal multipoint station address (either the poll or select sequence can be 
specified). See “ALTERCOM Procedure” in Chapter 2 for a list of valid 
hexadecimal multipoint station addresses. 
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Example 

This example, using the STARTM procedure command, shows how to specify line 
1 to be automonitored for an EBCDIC station address of C4. 

STARTM 1,E,C4 

Refer to Appendix D for the format of this command. 


STATEST Procedure 

The STATEST procedure tests the communications line and the controller used for 
remote display stations and printers. It also tests SSP-ICF Finance controllers and 
SSP-ICF secondary Peer connections. (System/36 is the primary station for APPC 
or SSP-ICF Peer.) 

You can run the test on either a switched or nonswitched line. On a nonswitched 
line, you can test up to seven secondary remote stations with a single run of the 
test. The autocall feature cannot be used for this test. 

Note: A test for APPC configuration can only be run on a mmwitched line. 

The system you are running from will send out a test command to the remote 
locations you specify. If the remote stations respond properly, the transmission is 
successful. If the remote stations do not respond properly, or do not respond at all, 
the transmission is not successful. 

After you have begun the test transmissions, no remote station that is being tested 
can be placed online until the test has completed. If you wish to end the test, press 
command key 7. 


Example 


To start the STATEST procedure, enter: 

STATEST 
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Ruiming the STATEST Procedure 


After you enter the STATEST procedure command, the following display appears: 



PRIMARY LINK STATION TEST 



Communications line number . 

Number of test transmissions . 

Number of seconds between transmissions • • 
Log successful transmissions to history file? 
Switched line type . 


Cmd7-End 



1 , 2 , 3 , 4 , 5 , 6 , 7,8 2 

. 1-999 2 

. 0-20 0 

.y,N N 

. . . .AA,MC,MA AA 


(c) 1984 IBM Corp^^^ 


Figure 7-1. Primary Link Station Test Display with Sample Data 


Communications line number specifies the number of the communications line 
containing the stations or controllers to be tested. The default for this prompt is 
1; a 2 is entered in the example. 


Number of test transmissions specifies the number of test transmissions to be sent to 
the stations or controllers; a 2 is used in the example. 


Note: If you are using an X. 21 SHM line, too many test transmissions may tie up 
the line and cause other controllers on the line to drop off. 

Number of seconds between transmissions specifies the time interval, in seconds, 
between successive transmissions. On an X.21 SHM line, a low number of 
seconds is recommended. 


Log successful transmissions to history file? specifies whether successful 

transmissions are to be logged to the history file. N means do not log; Y means 
log. If you choose to log, for each test transmission that is successful, message 
SYS-3498 is logged to the history file. 

Switched line type prompt appears if the line you entered in the first prompt is a 
switched line. Enter one of the following line types: 

AA Autoanswer 

MA Manual answer 

MC Manual call 
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After you complete the prompts and press the Enter key, the display shown in 
Figure 7-2 appears. 




STATION SELECTION OPTIONS 


Select one of the following: 


1 . 

2 . 

3. 

4. 

5. 


Specify remote control units to be tested. 

Specify an SSP-ICF subsystem configuration to be tested. 
Specify non-configured stations to be tested. 

Display the test configuration. 

Begin the test. 


Option: 


Cmd3-Previous display Cmd7-End 

V_ 



Figure 7-2. Station Selection Options Menu 

Select the option that corresponds to the test you want to perform. 

If you selected option 1, see Figure 7-3. 

If you selected option 2, see Figure 7-4. 

If you selected option 3, see Figure 7-6. You cannot select option 3 for an X.25 
line because an X.25 line requires an X.25 configuration member. 

If you selected option 4, see Figure 7-7. 

If you selected option 5, see “Beginning the Test Transmission” later in this 
chapter. 

Note: You cannot run option 1 and option 2 at the same time for an X.25 line. 
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This display allows you to select the remote work station controllers you want to 
test. Enter the number corresponding to the controller you want to test. In the 
sample display, the operator entered 1 to test controller COl and 2 to test 
controller COS. When you have completed the display, press the Enter key to 
return, to the Station Selection Options menu (Figure 7-2). 



Figure 7-3. Sample Remote Work Station Display 

This display allows you to enter the name of the Interactive Communications 
feature (SSP-ICF) subsystem configuration that contains the locations you want to 
test. In the sample display, the operator entered COMMl and #LIBRARY. The 
configuration must be SNA finance, APPC, or peer. If you are testing an APPC or 
peer connection, a secondary subsystem must be enabled on the System/36 that 
you are testing to. When you have completed the display, press the Enter key to 
select the SSP-ICF locations you want to test (Figure 7-5). 



F^ure 7-4. Sample SSP-ICF Configuration Display 
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This display allows you to select the SSP-ICF locations you want to test. Enter the 
number corresponding to the location you want to test. In the sample display, the 
operator entered 1 to test location LOCI and 3 to test LOC3. When you have 
filled out the display, press the Enter key to return to the Station Selection Options 
menu (Figure 7-2), 



Figure 7-5, Sample SSP-ICF Locations Display 


This display allows you to enter the address of each station or remote work station 
controller you want to test. You can also assign a name to that station. This name 
will be displayed along with the address if a transmission error occurs. In the 
sample display, the operator entered 05 to test an address and entered 03 and 
NEW^ORK to test the station at that address. When you have completed the 
display, press the Enter key to return to the Station Selection Options menu (Figure 
7-2). 

NON-CONFIGURED STATION SPECIFICATION 
Enter the addresses of the stations to be tested: 

ADDRESS STATION NAME (optional) 

1. 05 

2. 03 NEWYORK 

3. 

4. 

5. 

6 . 

7. 



Figure 7-6. Sample Nonconfigured Station Specification 
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If you selected option 4, this display shows the test configuration you have 
selected. If the display is correct, press the Enter key to return to the Station 
Selection Options menu (Figure 7-2). If the display is incorrect, press command 
key 7 (Cmd7) to return to the Main Help menu and start the STATEST procedure 
again. 



Figure 7-7. Sample Station Test Connguration 


Beginiiing the Test Transmission 


When you select option 5, the display in Figure 7-8 appears indicating that the tests 
have begun transmitting. 



Figure 7-8. Sample Station Test Transmission Display 
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Successful test transmissions result in informational messages that, if you selected 
the logging option on the first menu, are logged to the history file. Unsuccessful 
transmissions result in displayed messages that require a response. 

I If the Waiting for a connection message appears on the display, your station is 

I waiting for a call from the remote or secondary location. When either station calls 

I in to make the connection, test transmission will be started. 

If you receive a message indicating an unsuccessful transmission, you must respond 
by taking one of the following options: 

Option Meaning 

0 Continue the transmissions to all stations 

1 Stop the transmissions to the stations that responded unsuccessfully, but 
continue the transmissions to the other stations 

2 Select a new test configuration 

3 Cancel the STATEST procedure 

When the test is complete, a message appears for about 3 seconds indicating the 
completion. After 3 seconds, the Primary Link Station Test display appears Figure 
7-1 and you can select more tests to be done or end the procedure. 

Notes on Running STATEST 

If a station you are trying to test does not respond correctly, ensure that it is in the 
correct status for the test. For remote work stations, the control unit being tested 
must be turned on and offline (other control units can be online). For SNA 
finance stations, the 3601 4700 controller being tested must be turned on and IPL 
I must have been performed if necessary (other controllers can be online and 

1 enabled). For peer or APPC connections, the remote station must have been 

enabled using the ENABLE procedure. 
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STOPM Procedure 


This procedure stops the automatic monitoring function of a BSC multipoint line. 
The line being monitored could have been previously placed in automatic monitor 
mode in one of three ways: 

• By the STARTM procedure 

• By disabling an SSP-ICF BSC subsystem 

• By the ending of a batch BSC job 

The STOPM procedure runs the $MMSP utility program. 


STOPM PROCEDURE 

Stops the automatic monitoring of a communication line 
Communications line number . 1-8 


Cmd3-Previous menu Cmd4-Put on job queue 


(c) 1985 IBM Corp. 





Communications line number specifies that automatic monitor mode is to be stopped 
for the specified line. You can enter a number from 1 through 8. This line must 
be a multipoint line. 


Example 


Using the STOPM procedure command to stop automonitoring line 1, enter: 

STOPM 1 

Refer to Appendix D for the format of this command. 
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Chapter 8. Requesting a Network Facility for X.21 


REQUESTX Procedure 

The REQUESTX procedure allows you to request or cancel an available user 
facility in an X.21 public data network. Depending on the network, registration for 
a variety of facilities or services can be done by service order at subscription time, 
or over the network itself by using the REQUESTX procedure. The REQUESTX 
procedure can be entered from any display station. 

The REQUESTX procedure has two modes of operation: 

• When no parameters are specified, you are prompted for the requests. 

• When you enter parameters, they indicate a library source member that 
contains one or more requests to be processed. This source member can be 
created by using the source entry utility (SEU) or the $MAINT utility program. 
See “Facility Request Source Member Specifications” later in this chapter for 
the format of these source statements. 

A report is printed after the REQUESTX procedure has transmitted the 
specifications. The report shows every registration and cancelation request, the 
communications line over which the request was transmitted, and the status of the 
request. The report also shows the total number of requests, and the number of 
successful and unsuccessful requests. 

The following conditions must exist before the REQUESTX procedure can request 
or cancel a network facility: 

1. At least one line must be configured as an X.21 switched or short hold mode 
line. 

2. The X.21 switched or short hold mode line associated with the facility being 
registered or canceled must be available. Therefore, the REQUESTX 
procedure should be run before running the communication component that 
requires the facility. 

The system assumes that you are familiar with the specifications of the X.21 public 
data network to which the system is attached. You must enter the selection 
sequence in the proper format, using the proper field delimiters, and the correct 
numeric codes for the facility being registered or canceled. 
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Because the request and cancel specifications differ from network to network, the 
system does not check the syntax of the selection sequence. However, the system 
will verify that any characters entered match the following: The numeric digits 0 
through 9, h 3 q)hens (-), periods (.), commas (,) and slashes (/). After the line 
number and the sequence have been entered, press the Enter key to transmit the 
specification to the network. 

After the specification is transmitted, a message is displayed indicating whether the 
specification was successful. You then can transmit more specifications. 

To end the REQUESTX procedure, press command key 7. 

The REQUESTX procedure runs the #GCFR utility program. 

Following is the REQUESTX Procedure prompt display and an explanation of the 
parameters: 



Runs the X.21 


REQUESTX PROCEDURE 

registration and cancellation utility 


Name of source member . 

Name of library containing source member . 

Data entry required . NOENTRY,ENTRY 


Optional-* 


#LIBRARY 

NOENTRY 


Cmd3-Previous menu 



(c) 1983 Corp. ^ 


Name of source member specifies the library source member that contains 
registration and cancelation specifications. See “Facility Request Source 
Member Specifications” later in this chapter for the format of these 
specifications. 

Name of library containing source member specifies the library that contains the 
source member. If no name is specified, the current library is assumed. 

Data entry required specifies whether the source entry utility is to be called. 

NOENTR Y specifies that the source entry utility (SEU) is not to be called, and 
that the specifications in the indicated source member are to be transmitted. 

ENTR Y specifies that the source entry utility (SEU) is to be called to create or 
change the source member before the specifications are transmitted by the 
REQUESTX procedure. 
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The following two examples use the REQUESTX procedure prompt. Refer to 
Appendix D for the format of this prompt. 


Example 1 

This example shows how to start the REQUESTX procedure, which will then 
prompt for the requests. 

REQUESTX 

Example 2 


This example shows how to start the REQUESTX procedure, which will then 
process the library source member REQ from the current library (named MYLIB). 

REQUESTX REQ 

Facility Request Source Member Specifications 

The specifications can be entered by using SEU or the $MAINT utility program. 
See the manual SEU Guide for more information about SEU; see the manual 
System Reference for information about $MAINT. The specifications must be 
entered in positions 1 through 25 of the source member. 

A display format is provided to allow you to enter or change the specifications 
using SEU; it is named REQX. However, this format is only available if you are 
using the REQUESTX Procedure prompt display or if you include format member 
name #GC(a)REQX on the SEU Sign-On display. 

Positions Contents 

1 The communications line number. This can be any number from 1 
through 8. 

2 to 25 The registration or cancelation requests. The requests must start in 

position 2. 
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Chapter 9. Configuring for Advanced Program-to-Program 
Communications 


What Is APPC? 

Advanced program-to-program communications (APPC) is the System/36 
implementation of the SNA LU6.2 architecture, which is the SNA defined standard 
for program-to-program communications. The support provided by APPC in the 
Communications feature supports the basic conversation part of APPC only; 
mapped conversations are supported by the SSP-ICF APPC subsystem. SSP-ICF 
is a separately priced feature. 

With APPC, System/36 can communicate with other products that use SNA LU6.2 
protocols, such as another System/36, System/38, CICS/VS, 5520, or 
Displaywriter. APPC allows application programs on different products to 
communicate. The System/36 APPC subsystem supports both batch and 
interactive communications. 

With APPC, communications occurs as peer communications, which means that no 
single system is the host (when System/36 communicates with CICS/VS, 

CICS/VS is considered to be a host for configuration and bring-up only.) One of 
the systems in the network must be the primary station, and all others must be 
secondary. APPC supports point-to-point switched, point-to-point nonswitched, 
multipoint nonswitched communications lines, X.21 communications, and X.25 
communications. 

Note: APPC does not run with X.21 short hold mode. 

APPC Sessions 


With APPC, no single system is responsible for the control of all the 
communications sessions. Control of the sessions is distributed among the systems 
in the network. For example, when two systems communicate using APPC, each 
starts (binds) and ends (unbinds) some sessions. Those sessions for which a 
particular system is responsible are locally controlled sessions, since that system is 
the initiator of those sessions. Sessions for which another system is responsible are 
called remotely controlled sessions. 
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The Number of locally controlled sessions prompt on display 43.0 for CNFIGICF 
allows you to specify the minimum number of locally controlled sessions that are to 
be initially allocated on the local system for a particular session group. The actual 
number of sessions will be negotiated (automatically) with the remote system and 
may be less. The STATUS APPC command can be used to determine the actual 
number of sessions. Also, the total number of locally controlled and remotely 
controlled sessions may be less than the number shown for the maximum allowed 
sessions field on the status APPC display. The remaining sessions (those not 
initially controlled by either system) are available on a first requester basis. 

Remotely controlled sessions that have been bound but are still available may be 
used by the local system if a session is needed and no locally controlled sessions are 
available. For this to occur, you must respond to the Acquire remotely controlled 
sessions? prompt on display 44.0 with a Y (yes). 


Configuring an APPC Subsystem 

An APPC subsystem must be configured if you intend to use: 

• Communications and Systems Management alert support 

• Distributed Data Management (DDM) 

. PS/36 

. The SSP-ICF APPC Subsystem 

• Display Station Pass-Through 

To configure an APPC subsystem, enter CNFIGICF. 
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Display 1.0 SSP-ICF Configuration Member Defim'tion 



SSP-ICF CONFIGURATION MEMBER DEFINITION 



1. Configuration member name . APPCSUB 

2. Library name.#LIBRARY 


3. Select one of the following; 

1. Create new member 

2. Edit existing member 

3. Create new member from existing member 


4. Remove a member 

5. Review a member 

Option.1-5 3 

4. Existing member name . 

5. Existing member library name . #LIBRARY 


Cmd7-End Cmd19-Cancel 



Configuration member name specifies the name that identifies this configuration of 
the subsystem. This subsystem member name is used to store the subsystem 
configuration member in a library, and it is also used in the ENABLE and 
DISABLE procedures to start and stop the subsystem. APPCSUB is used in this 
example. 

Library name specifies the name of the library in which the subsystem member is to 
be stored. The default is the current user library. 

Note: The line member and subsystem member must be in the same library. 

Select one of the following; Specify which of the five options you want. For 
example, if you are creating a new subsystem member, select option 1. 

Existing member name is displayed only if you selected option 3 for prompt 3. 

Enter the name of the existing subsystem member that is to be used to create the 
new member. (The existing member is not changed.) 

Existii^ member library name is displayed only if you selected option 3 for prompt 
3. Enter the name of the library that contains the existing member. The default 
is the library name specified for prompt 2. 
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Display 2.0 SSP-ICF Configuration Member Type 



SSP-ICF CONFIGURATION MEMBER TYPE 


Select one of the following options: 

1. INTRA 

2. BSC 

3. SNA 

4. Async 

Option . 



1-4 3 


Cmd3-Previous display 



Cmd19-Cancel I 

COPR IBM Corp. 1986 


On this display, select the type of configuration you are working with. Since you 
are defining a subsystem for APPC, select option 3, SNA. 

Note: A line member must be defined before a subsystem member can be defined. 
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I Display 4.0 SNA Configuration Member Type 



I On this display, you select the type of SNA member you are working with. 

1 1 SNA member type specifies the type of SNA member this subsystem is to use. 

I Select option 1, SNA subsystem member. 
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Display 21.0 SNA Subsystem Member Selection 



21,0 SNA SUBSYSTEM MEMBER SELECTION APPCSUB 

1. Line member name.. . . APPGLINE 


2. Select subsystem type from the following options: 

1. Peer 

2. SNA Upline 

3. SNA 3270 

4. Finance 

5. SNA MSRJE 

6. APPC 

Option . ..... 1-6 6 



Cmd3-Previous display 



Cmd19-Cancel 

_ J 


On this display, you select the type of subsystem you are working with. Using 
APPC, your System/36 can communicate with another System/36, a System/38, 
CICS/VS, DisplayWriter, or another system with compatible support. 

1 Line member name specifies the name of the line member with which this 
subsystem member is to be associated. The line member name was specified 
on display 1.0 during line member configuration. The line member for this 
example is APPCLINE. 

2 Select subsystem type from the following options: For APPC, specify 
option 6. 
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Display 22.0 Subsystem Member Definition 



On this display, you supply the name of the local (your System/36) location and 
the identifier of the APPC network. 

1 Location name specifies the name of your location. Your location is 

considered the local location. This name is also used by the remote locations 
to identify your system. This name must match one of the remote location 
names specified on the remote system’s configuration/definition. 

• If the remote system is a System/36, the name specified here must be the 
same as the Remote location name specified on display 29.0 during APPC 
configuration at the remote system. 

• If the remote system is a System/38, the name specified here must match 
the value specified for the RMTLU parameter of the CRTDEVD (Create 
Device Description) command. 

• If the remote system is CICS/VS, the name must be the same as that 
specified for the NETNAME parameter during CICS/VS terminal 
control table definition (using the DFHTCT macroinstruction). 

• If the remote system is a Displaywriter, the name specified here must be 
the same as that specified for the Destination LU Name prompt on the 
Document Distribution Setup menu. 

• If the remote system is a 5520, the name specified here must be the same 
as that specified for the remote node name in the 5520 remote node 
profile prompt. 

This name appears in system messages at both the local and remote systems 
to help associate messages with a particular location. 
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5 Network ID specifies the network ID to use to qualify the local location name 
during the activation sequence. This is only shown for remote system type 
Host. 

Note: If the network ID is not specified, the local location name will not be 
qualified. 

Display 29.0 Remote Location Selection 


29.0 


REMOTE LOCATION SELECTION 


1. Select from the following options: 

1- Create 3-Create from existing 

2- Edit 4-Remove 


5-Review 


Option . 

2. Remote location name . 

3. Remote system name . . 

4. Existing location name 


OPTION LOCATION REMOTE SYSTEM 

APPCREMO 


APPCSUB 



1 


Page 1 of 1 


Cmd8-Reset Cmdl9-Cancel Roll-Page 

No remote locations are configured 



On this display, you select the remote systems this subsystem communicates with. 
This display shows the remote systems in the line member that are available to 
communicate with this subsystem. For each remote system that you select, you 
define its associated remote location(s). 

Each previously defined remote location is listed along with the remote system with 
which the remote location is associated. You may edit, remove, or review any of 
these remote locations by entering the correct option number in the column to the 
left of the remote location with which you want to work. Use the Roll keys to page 
through the list of remote locations. 

If no locations have been defined for any of the remote systems in the line member, 
the only option shown on display 29.0 is 1-Create. 

1 Select from the following options: Specify which of the available options you 
wish to use: 

1- Create defines a new remote location. 

2- Edit changes an existing remote location. 

3- Create from existing defines a new remote location using an existing remote 
location as a base. 
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4- Remove removes a remote location. It will no longer exist in this member. 

5- Review displays an existing remote location. The configuration member 
cannot be changed. 

2 Remote location name specifies the name of the remote location associated 
with this remote system with which this subsystem is to communicate. This 
name is used in the ENABLE, DISABLE, STRTGRP, and STOPGRP 
procedure commands to start and stop communications with this remote 
location. This name is used by System/36 APPC to identify the remote 
location. This name appears in system messages to help the operator associate 
the message with a particular remote location. 

No two remote location names in this subsystem member can be the same. 

This name must match the local location name specified in the remote system’s 
configuration/definition. 

• If the remote system is a System/36, the name specified here must be the 
same as the Location name specified on display 22.0 during APPC 
configuration at the remote system. 

• If the remote system is a System/38, the name specified here must match 
the value specified for the LCLLU parameter of the CRTDEVD (Create 
Device Description) command. 

• If the remote system is CICS/VS, the name must be the same as that 
specified for the APPLID parameter during CICS/VS DFHTCT control 
table definition (using the DFHTCT macroinstruction). 

• If the remote system is a Displaywriter, the name specified here must be 
the same as that specified for the Origination LU Name prompt on the 
Document Distribution Setup menu. 

• If the remote system is a 5520, you must define two remote location 
names (one for SEND and one for RECEIVE) with the same remote 
system name. The names specified here must match the names specified 
on 5520 for SEND and RECEIVE sessions of the Create Send and 
Receive Session function. 

3 Remote system name specifies the name of the remote system for which this 
remote location is being defined. 

4 Existing location name specifies the name of the existing remote location that is 
to be used as a base when creating a new remote location if you selected 
option 3 for the first prompt. 

When you select option 1, a remote location definition is built by CNFIGICF. 
Display 29.0 is then redisplayed with the new remote location name listed with the 
associated remote system. If you want to change any of the values assigned for the 
remote location, you must edit the remote location using option 2. You can either 
key the option number (2), the remote location name, and the remote system name 
and then press the enter key; or you can simply enter a 2 to the left of the remote 
location that you want to edit. If you simply want to view the definition, select 
option 5. 
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Display 30.0 Remote Location Definition 


30.0 REMOTE LOCATION DEFINITION APPCSUB 

Remote system APPCREMO Remote location REMOTE01 

1. Activate location at ENABLE? . Y,N Y 

2. Send alerts to this location?.Y,N N 


W1 


Cmd3-Previous display Cmd7-End Cmdl9-Cancel 




This is the first of a set of displays that define a remote location for this remote 
system. On this display, you specify how you want the remote location started 
using the ENABLE procedure command and whether C & SM alerts will be sent to 
the remote location. The remote system and remote location names are shown for 
reference. 

1 Activate location at ENABLE? specifies whether this location should be 
activated (started) when an ENABLE procedure command is entered that 
specifies the subsystem member but no remote location name. 

Y (yes) specifies that communications with this remote location can start when 
the ENABLE procedure command is entered without a remote location name 
being specified. Specify Y if this is the only remote location in this subsystem 
member. 

N (no) specifies that communications with this remote location can start only 
when an ENABLE procedure command is entered specifying this remote 
location name. 

2 Send alerts to this location? specifies whether alerts can be sent to this location. 
System/36 alerts are generated by the alert support portion of the 
Communications and Systems Management feature. 

Y (yes) specifies that alerts can be sent to this remote location. This prompt is 
only shown for a host remote system. Only one remote location within a 
remote system can be defined to receive alerts. For additional information 
about alerts, see the Communications and Systems Management Guide. 

If you specify Y for this prompt, you have completed defining a remote 
location and display 29.0 is presented. You can then end CNFIGICF or select 
any of the options offered by display 29.0. 

N (no) specifies that alerts will not be sent to this remote location. 
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Display 41.0 APPC Location Definition 


41.0 APPC LOCATION DEFINITION APPCSUB 

Remote system APPCREMO Remote location REMOTE01 

1. Single session location? . Y,N N 

2. Stay operational?.Y,N Y 


W1 


Cmd3-Previous display Cmd7-End Cmdl9-Cancel 



On this display, you specify whether the remote location has a single session or can 
have multiple sessions, and whether the remote location will stay enabled after the 
line has been disconnected. The remote system and remote location names are 
shown for reference. 

1 Single session location? specifies whether the remote location is limited to one 
session. 

Y (yes) specifies that this remote location is limited to one session group with 
a maximum session limit of 1. This may be required by the remote system 
with which you are communicating. For example, CICS/VS, 5520, and 
Displaywriter, which are single session locations, all require that Y (yes) must 
be specified. 

N (no) specifies that this remote location can have up to 8 session groups with 
a total of 64 sessions. 

2 Stay operational? specifies whether you want the subsystem to remain active 
after the line has been disconnected. 

Y (yes) specifies that the remote location stays enabled following a normal line 
deactivation. This allows reestablishing communications with the remote 
location at a later time. 

N (no) specifies that the remote location is disabled when the line is 
disconnected. 



Chapter 9. Configuring for Advanced Program-to-Program Communications 9-11 





Display 42.0 Session Group Selection 


42.0 SESSION GROUP SELECTION APPCSUB W 

Remote system APPCREMO Remote location REMOTE01 

1. Select from the following options: 

1- Create 3-Create from existing 5-Review 

2- Edit 4-Remove 

Option . 

2. Session group name... 

3. Existing session group name. 

4. Default session group name . *BLANK 

OPTION SESSION GROUP 
♦BLANK 
NEWGRP 




Cmd19-Cancel _ ^ 


This display lists the session groups that are defined for this remote location. You 
can create a new session group, edit an existing session group, remove a session 
group, create a new session group from an existing session group, or review a 
session group. In addition, you specify the name of the session group that is to be 
used as the default. The remote system and remote location names are shown for 
reference. 

Select from the foUowing options: 

1- Create defines a new session group. 

Note: If you had specified Y for Single session location on display 41.0, you will 
need to remove the Default session group name, *BLANK, on the top half 
of this display before you can define a new session group. 

2- Edit changes an existing session group. 

3- Create from existing defines a new session group using an existing session 
group as a base. 

4- Remove removes a session group. It will no longer exist in the member. 

5- Review displays an existing session group. The configuration member cannot 
be changed. 

2 Session group name: Each session group name must be unique within the 
remote location. There can be from one through eight (only one for a single 
session location) session groups for each remote location, with a maximum of 
120 session groups for the entire APPC subsystem configuration. The name 
SNASVCMG cannot be used. To configure a session group name of blanks, 
the name *BLANK must be specified. 
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The name specified here must match the corresponding value at the remote 
system. The name is specified at the remote systems as follows: 

• System/36: By the Session group name prompt on display 42.0 during 
APPC subsystem member configuration. 

• System/38: By the MODE parameter on the ADDDEVMODE (Add 
Device Mode Entry command. 

. CICS/VS: By the MODENAM parameters of the DFHTCT (Define 
Terminal Control Table) and referenced by the DFHPCT (Define 
Program Control Table) macroinstructions. 

• Displaywriter: You must specify *BLANK. 

• 5520: By the remote node name specified on the 5520 Remote Node 
Profile prompt. 

3 Existing session group name specifies the name of the existing session group to 
be used as a base when creating a new session group (option 3). 

4 Default session group name specifies that the default session group name will 
be used by the APPC subsystem whenever a local application program does 
not explicitly provide a session group name at session initiation. The default 
session group name must be a session group name already configured for this 
remote location. 

All previously defined session groups for the given remote system and remote 
location are listed. You may edit, remove, or review any of these session 
groups by entering the correct option number in the column to the left of the 
session group you want to work with. 
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Display 43.0 APPC Session Group Definition 


43.0 APPC SESSION GROUP DEFINITION APPCSUB 

Remote system APPCREMO Remote location REMOTE01 

Session group NEWGRP 


W1 


1. Session group type ..1 

1-Interactive 2-Batch 

2 . Maximum session limit.1 - 56 08 

3. Number of locally controlled sessions.0 - 08 04 

4. Number of pre-established sessions.0 - 04 00 


Cmd3-Previous display Cmd7-End Cmd19-Cancel 

V 



This is the first of a set of screens that you use to define the session groups. The 
remote system name, remote location name, and session group name are shown for 
reference. 

1 Session group type specifies whether the sessions are to be used for batch or 
interactive communications. This is used to select defaults at the local system 
for display 44.0. 

1- Interactive should be used if the record exchange is in both directions, 
meaning that the systems alternate sending and receiving. 

2- Batch should be used if the data record exchange is in a single direction. For 
example, you send a complete file to the remote system and then end 
communications. 

Note: The Session group type is used to determine the default values for display 
44.0. 

2 Maximum session limit specifies the maximum number of sessions that are 
allowed for this session group. The maximum number of sessions for all 
session groups in a single remote location is 64. The default is 8. This prompt 
is not displayed if the remote location is a single session location, and its value 
is automatically set to 1. Both Display writer and 5520 are single session 
locations. 

For other than single session locations, the value specified here might be 
automatically negotiated with the remote system and therefore might change. 
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3 Number of locally controlled sessions specifies the number of locally controlled 
sessions that are requested for this session group. The range of available 
sessions is shown and the default is one half of the maximum session limit. 

This value is actually negotiated with the remote system when the 
communications link is established. Therefore, the number specified here is not 
a guaranteed value. 

If the remote system is a Display writer, you must specify 1. If the remote 
system is 5520, specify 0. If the remote system is CICS/VS, specify either 1 or 
0 . 

If the remote system is CICS/VS, specify either a 0 or a 1. 

• If 0 is specified, either System/36 or CICS/VS can acquire a session. 

• If 1 is specified, System/36 can acquire a session, but CICS/VS cannot 
acquire a session on System/36. 

4 Number of pre-established sessions specifies the number of sessions to be 
established and kept active while communications with the remote location is 
active. The default is the number of locally controlled sessions if the line type 
is nonswitched or switched without automatic disconnect. The default is 0 if 
the line type is switched with automatic disconnect. 

Specify 0 if the remote system is 5520. 

Specify 1 for Displaywriter if the Displaywriter is secondary. 

The number of sessions specified here is not guaranteed. It applies to locally 
controlled sessions only and negotiation between the systems may reduce the 
number. 
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Display 44,0 APPC Session Group Additional Options 


44.0 APPC SESSION GROUP ADDITIONAL OPTIONS APPCSUB 

Remote system APPCREMO Remote location REMOTE01 

Session group NEWGRP 

1. Receive pacing value.1-63 07 

2. Maximum receive RU size.8-4096 1024 

3. Acquire remotely controlled sessions? . Y,N N 


W1 


Cmd3-Previous display Cmd7-End Cmdl9-Cancel 

v__ 




I 


On this display, you define additional options that can affect performance for this 
session group. The remote system name, remote location name, and session group 
name are shown for reference. 

1 Receive pacing value specifies the number of RUs (request units) that may be 
sent to the remote location without an intervening pacing response. The 
default is 7 if the session group type is interactive and 3 if it is batch. 

2 Maximum receive RU size specifies the maximum RU size (in bytes) that can 
be received by the APPC subsystem. The default is 1024 if the session group 
type is interactive and 256 if it is batch. 

Note: Maximum session limit. Receive pacing value, and Maximum receive RU 
size are factors in how much storage C/SNA reserves for session buffers. 
The larger the values, the more storage C/SNA uses. You must be 
careful to not overcommit storage for your machine. 

3 Acquire remotely controlled sessions? specifies whether, if there are no locally 
controlled sessions available, the subsystem should attempt to acquire a 
session controlled by the remote system. If the remote location is a 
single-session location, this prompt is not displayed; the value for this prompt 
is automatically set to yes. 

Y (yes) specifies that if there are no locally controlled sessions available, the 
APPC subsystem will attempt to allocate a remotely controlled session to any 
local application program using this session group. The default is yes if the 
remote location is not a single session location. 

N (no) specifies that the APPC subsystem will not attempt to allocate a 
remotely controlled session to any local application program using this session 
group. 
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Chapter 10. Startii^ and Stopping APPC Session Groups 


Startii^ a Session Group (STRTGRP Procedure) 

The STRTGRP procedure command starts or activates an APPC session group. 
You must use this procedure command before running DDM, the SSP-ICF APPC 
subsystem, Display Station Pass-Through, or the document distribution function of 
PS/36, 

Note: The APPC subsystem must be enabled (using the ENABLE procedure 
command) and ready to communicate with the remote system before the 
STRTGRP procedure command can be used to activate the session groups 
defined for the remote locations in the subsystem. 

The STRTGRP procedure command can be used to start all configured session 
groups for a location, or to start one session group only. Following is the 
STRTGRP procedure command prompt display and an explanation of the 
parameters: 



starts a single session group or all configured 
session groups for an enabled remote location. 


Name of remote location.. 

Name of single session group to be started 



Name of remote location specifies the remote location for which one or more 
session groups are to be started. This name must have been previously specified 
for the Remote location name prompt on display 29.0 during APPC subsystem 
member configuration. 
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Name of single session group to be started specifies the session group that is to be 
activated. The session group is started if it is not already active. The name 
specified here must have been previously specified for the Session group name 
prompt on display 42.0 when the location identified in the previous prompt was 
defined. 

If no name is specified, all session groups within the location that are not 
currently active are started. 

The following two examples use the STRTGRP procedure command. Refer to 
Appendix D for the format of this command. 


Example 1 

In the following example, the STRTGRP procedure command starts all session 
groups for the remote location APPCLOCl: 

STRTGRP APPCLOCl 

Example 2 


In the following example, the STRTGRP procedure command starts one session 
group (GROUPl) for the remote location APPCLOCl: 

STRTGRP APPCLOCl,GROUPl 
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Stopping a Session Group (STOPGRP Procedure) 


The STOPGRP procedure command closes one or more active APPC session 
groups. You can also specify how activities that have been requested on the 
remote system but have not yet been performed are to be handled. 

Following is a copy of the STOPGRP procedure prompt display and an explanation 
of the parameters: 


STOPGRP PROCEDURE 


Stops a single session group or all configured 
session groups for an enabled remote location. 


Optional-* 


A 


Name of remote location. 

Name of single session group to be stopped 

Complete requested activity before ending 
session in specified session groups(s)? 




.N,Y N 


(c) 1985 IBM Corp. 


Name of remote location specifies the remote location for which one or more 
session groups are to be stopped. 

Name of single session group to be stopped specifies the session group that is to be 
stopped (closed). If a name is specified here, only that session group is stopped; 
any other active session groups for the location remaining active. 

If no name is specified, all active session groups for the remote location are 
stopped. 

Complete requested activity before ending session in specified session group(s)? If 
you specify N, requested activities currently in process at the remote location 
will complete; activities that have been requested but not yet started at the 
remote system will not be performed. Y specifies that all requested activities be 
allowed to complete before the session group is terminated. N is the default. 

In either case, no new activities can be requested on the local system for the 
session group once the STOPGRP command has been entered. 
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The following two examples use the STOPGRP procedure command. Refer to 
Appendix D for the format of this command. 


Example 1 

In the following example, the STOPGRP procedure command stops all active 
session groups for the remote location APPCLOC1. All requested activities can 
complete before the session group terminates. 

STOPGRP APPCLOC1,,Y 

Example 2 


In the following example, the STOPGRP procedure command stops one active 
session group (GROUP 1) for the remote location APPCLOC 1. Only requested 
activities that are in process will complete: 

STOPGRP APPCLOC1,GROUP1 
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Chapter 11. Asynchronous Communications Support 


The IBM System/3 6 asynchronous communications support, part of the base 
Communications feature, lets System/36 use the asynchronous protocol to 
communicate with a remote station, either directly or over a packet-switched data 
network. 

Asynchronous communications includes the following parts: 

• The asynchronous communications subsystem 

The asynchronous communications subsystem supports program-to-program 
communications between systems using the asynchronous and/or enhanced 
X.25 data link protocols. It also provides an internal X.25 Packet 
Assembler/Disassembler (PAD) function, which allows a terminal connected 
to System/36 to communicate with a host system over a packet-switched data 
network (PSDN). Refer to the Using the Asynchronous Communications 
Support manual, for more information about the asynchronous communications 
subsystem. 

• The file transfer subroutines (also used by other subsystems) 

The file transfer subroutines let you send System/36 data files and library 
members through the data network. These subroutines are called from your 
application programs. See Chapter 12, “File Transfer Subroutines” for more 
information. 

• The Interactive Terminal Facility 

The Interactive Terminal Facility (ITF) allows System/36 to connect to 
applications such as the TELEMAIL service of the GTE Telenet data 
network.^ Using ITF, you can send or receive not only simple memos, but also 
System/36 library members and data files. You can also send Displaywrite/36 
documents. Refer to the Using the Asynchronous Communications Support 
manual for more about ITF. 


TELEMAIL and Telenet are registered servicemarks of the GTE Telenet 
Communications Corporation. 
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• The SLCA feature (provides support for a second communications line for 
asynchronous communications only) 

SLCA support allows a System/36 with the single line communications adapter 
(SLCA) to use a second communications line. Line 1 can be a BSC, SDLC, or 
an asynchronous line; line 2 must be an asynchronous line with an 
EIA/CCITT card and cable. Refer to the Using the Asynchronous 
Communications Support manual, for more information about this second 
communications line. 

• Support for multiple X.25 lines (also used by other subsystems) 

Support for multiple X.25 lines lets you configure up to three X.25 lines. For a 
System/36 with the 5360 System Unit, the eight-line communications adapter 
(ELCA) is required. For a System/3 6 with the 5362 System Unit, the 
multiline communications adapter (MLCA) is required. 
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Some Notes on Asynchronous/X.25 Configuration 


When you perform the CNFIGICF and CNFIGX25 procedures, you are describing 
to System/36 both your system and any remote systems with which you will be 
communicating. For an asynchronous/X.25 line, you are also describing the PSDN 
through which you will communicate. 

Part of the process of describing these things is naming them: Your system, the 
remote system, the line member, the subsystem member, the X.25 network 
configuration member, the X.25 virtual circuit configuration member. 

This section shows how these names are used together to allow communication to 
take place. The accompanying drawings show a sample system (S36A) and one of 
the remote systems with which it communicates (S36B). 

1. When you define a communications line configuration member (using 
CNFIGICF), you tell the system: 

• The name of the line member 

• The name of the X.25 virtual circuit configuration member that this line 
will use 

• How many remote systems this line member can communicate with 

• The names of remote systems that your system will call 

S36A Line Configuration Member 


Configuration member name = LINE1 
X.25 configuration member = X25VC1 
Total number of remote systems =10 
Remote system names: 

MNSYS 

PASYS 

TNSYS 

NESYS 

ALSYS 


AAA001-0 
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The system assigns station addresses to all remote systems. If you name fewer 
remote systems than the total number of remote systems, the remainder 
become generic remote systems. The system assigns numbers to these. They 
are used for incoming calls to your system. 

In the example, there are ten remote systems, but only five have been named 
by the user. The system treats the other five as generic remote systems. A 
remote system that calls in is assigned to an available generic remote system, 
and the calling system’s name replaces the generic number for the length of the 
session. The calling system must be defined to the remote system using the 
DEFINLOC procedure. 

Note: You may use the DEFINLOC procedure to define more remote systems 
than are assigned as generics. It is best to allow for only as many generic 
remote systems as you want to be calling your system at the same time. In 
the example, there could be twenty systems defined in the DEFINLOC 
list; five of these may call at once. 

S36A Remote System Names S36A DEFINLOC 


Location Name 

ID 

1. MNSBS 

MNID 

2. PASBS 

PAID 

3. TNSBS 

TNID 

4. NESBS 

NEID 

5. ALSBS 

ALID 

6. FLSBS 

FLID 

7. SCSBS 

SCID 

20. CASBS 

CAID 


AAA002-0 




MNSYS 


PASYS 

S36A uses these 

TNSYS 

’ for outgoing calls 

NESYS 

to remote systems. 

ALSYS J 


06 

S36A uses these 

07 

generic remote 

08 

► systems for 

09 

incoming calls 

OA J 

from remote systems. 
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2. When you define an asynchronous subsystem member, you tell the system; 

• The name of the subsystem member. 

• The name of the line member that this subsystem member uses. More than 
one subsystem member can be associated with the same line member, 
though only one subsystem member at a time can be enabled using that 
line member. 

• The subsystem’s location name and local ID. The remote system uses 
these names to recognize your system when your system calls; the remote 
system must have used the DEFINLOC procedure to list these names. 

• The name of the remote locations and the name of the remote system for 
each remote system that your system will be calling. 


S36A Subsystem Configuration Member 1 


Configuration member_nanTe^= 
Line member name *1 LINE1 j 
Location name = NCSBS 

Local ID « NCID 

SBS1 

Remote locations; Remote systems: 

MNLOC 

MNSYS 

PALOC 

PASYS 

TNLOC 

TNSYS 

NELOC 

NESYS 

ALLOC 

ALSYS 

06 

07 

08 

09 

OA 


S36A Line Configuration Member 


Configuration member name = j LIN El i 


S36A Subsystem Configuration Member 2 


Configuration member name = SBS2 
Line member name l_y NEI j 

« 

AAA003.1 


The location name, local ID, remote location name, and remote system name 
are all used by your system for outgoing calls to the remote system. Incoming 
calls from the remote system require a generic remote system name. 
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The location names defined by you and the other systems on the network must 
all be unique. In particular, you should be sure that the location name you 
specify for your system (for use in making calls to the remote system) is not the 
same as the name the remote system specifies as the remote location name (for 
use in making calls to your system). 


S36A 


Location name = NCSBS 

Local ID = NCID 

Remote locations: 

Remote systems: 

! MNLOC 

MNSYSl 

PALOC 

PASYS 

TNLOC 

TNSYS 

NELOC 

NESYS 

ALLOC 

ALSYS 

06 

07 

DEFINLOC: 

Location Name 

ID 

1 MNSBS 

MNID ! 

PASBS 

PAID 

FLSBS 

FLID 


S36B 


Location name = ! 

MNSBS 1 

Local ID = ! MNID 

■ ^ 

1 

Remote locations: 

Remote systems: 

NCLOC 

NCID 

PALOC 

PAID 

TNLOC 

TNID 

NELOC 

NEID 

ALLOC 

ALID 


06 


07 

DEFINLOC: 


Location Name 

ID 

NCSBS 

NCID 

TNSBS 

TNID 

FLSBS 

FLID 


AAA004-1 


3. When you define an X.25 network configuration, you tell the system the name 
of the network configuration. 

S36A X.25 Network Configuration Member 

Network configuration member 
name = X25NET1 


AAA005-0 
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4. When you define a virtual circuit configuration, you tell the system: 

• The name of the virtual circuit configuration member 

• The name of the associated X.25 network configuration member 

• The name of the associated line configuration member 

S36A Virtual Circuit Configuration Member 


S36A Line Configuration Member 

Configuration member name = L1NE1 
X.25 configuration member name = X25VC1 


AAA006-0 


Member name * X25VC1 

Related RWS or line configuration 
member name = LIN El 

X.25 network configuration member 
name = X25NET1 


S36A X.25 Network Configuration Member 


Network configuration member 
name = X25NET1 


As part of the virtual circuit configuration member, you define a virtual circuit 
for each of the remote systems defined using the CNFIGICF procedure. For 
generic remote systems, you can leave blank the remote network address 
parameter, thus creating generic virtual circuits. In both cases, the remote 
system must have been defined to your system through the DEFINLOC 
procedure. 
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D S36B places a call to S36A. 


S36B 


S36A 


Location Name = MNSBS 
Local ID = MNID 



The call is connected to 
the first available logical 
channel for incoming calls 


S36A checks to see if the 
location name and ID are 
listed in DEFINLOC. 


5. When you use the DEFINLOC procedure, you tell the system the location 
name and location ID of those remote systems that you allow to call your 
system. When a remote system calls, your system checks the names defined by 
DEFINLOC. If the location name matches one of these names, then the call is 
accepted and assigned to an available logical channel. 

DEFINLOC must be used to define your system’s location name and location 
ID to any remote system that your system will call if your station is not defined 
on the remote system’s virtual circuit configuration as an IN caller. 
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Configuring an Asynchronous Subsystem 


This section describes the displays and all the parameters (shown in prompt form) 
needed to define and create an asynchronous line member configuration, using the 
CNFIGICF procedure. 

The following diagram shows the sequence in which the CNFIGICF displays are 
presented, and shows what displays you use to create a communications line 
member and what displays you use to create a subsystem member. 

Refer to the Using the Asynchronous Communications Support manual for 
information about configuring the asynchronous communications subsystem. 

Note: You must define a line member for the communications line support before you 
can define an asynchronous subsystem member. If the line number is later 
modified, its new attributes are reflected in your subsystem the next time it is 
enabled. Some changes to the line member, however, also require that you 
modify each subsystem member using that line member before the subsystem is 
enabled again. To ensure compatibility between the line and the subsystem, 
you should always edit (modify) all the subsystem members affected by the 
changed line member. 


Start the CNFIGICF Procedure 


I 


Name the Member and Select the Type 

1.0 SSP-ICF Configuration Member Definition 
2.0 SSP-ICF Configuration Member Type 
5.0 Async Configuration Member Type 


r 


Define the Line Member 


12.1 Async Line Member Attributes 

12.2 Async Line Member Attributes 
- 

Define Remote System(s) 


12.5 Remote System Selection 


i 


Define the Subsystem Member 


25.0 Subsystem Member Definition 


Define Remote Locationis) 


29.0 Remote Location Selection 
60.0 Async Subsystem Attributes 
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Explanation of Displays 


On the following displays for the asynchronous CNFIGICF procedure: 

• All of the prompts that can be displayed to define an asynchronous line member 
are shown on the displays and are described in the text. The prompts are 
shown for all the parameters that are needed either to create a new 
asynchronous configuration member or to change (edit), delete, or review an 
existing member. 

Note: The prompt lines that you actually see on succeeding displays depend on the 
task specified on display 1.0 and on the options that you select on other 
displays. Prompt lines that are not shown do not apply for the task or 
options previously selected. 

• For this set of example displays only, the values to the right of the prompts are 
shown with: 

— Default values, supplied by the system. If the system provides a default 
value, that value is shown here. (You can enter a different value if you 
wish.) 

- Sample values, as typical examples. If fewer characters are shown than the 
field allows, the remaining positions in the field are underscored. Note that 
once a value has been entered in a field, it becomes the default value for 
any related fields on the succeeding displays. 


11-10 Using S/36 Communications 



I Line Member Definition 


I Display 1.0 SSP-ICF Configuration Member Definition 


On display 1.0, specify the name of the communications line configuration member 
you are creating or using in some way, and specify what is to be done with the 
member. 



I 1. Conf^uration member name: Enter the name that identifies this line 

I configuration member. This name is used to store the line member in a library 

I and is referenced in the subsystem configuration. 

I 2. Library name: Enter the name of the user library in which the line member is 

I to be stored. The default is the library that you are currently using. For best 

I results, do not store the member in the system library (#LIBRARY), because 

1 members you store in #LIBRARY may be lost if a release update is performed 

I later. 

I Note: The line member and the subsystem member must be in the same library. 

I 3. Select one of the following: 

I 1. Create a new member lets you specify the configuration values for a new 

I line member. 

I 2. Edit existing member lets you view and/or change the values previously 

( specified for a line member. 

I 3. Create a new member from an existing member lets you use an existing line 

I member as the basis for a new line member. You need change only those 

1 values necessary. The existing line member is unchanged by this option. 
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I 4. Remove a member lets you delete a line member from the library, Note 

I that the definition is no longer available once it is removed. If any 

I subsystem members reference the removed line member, an error occurs 

( when you attempt to use the subsystem member* 

I 5. Review a member lets you view the values specified for a line member. No 

I changes can be made, 

I 4. Existing member name: This prompt is displayed only if you select option 3 for 

I prompt 3. Enter the name of the existing subsystem configuration member 

I that is to be used to create the new member, (The existing member is not 

I changed.) 

I 5, Existing member library name; This prompt is displayed only if you select 

I option 3 for prompt 3- Enter the name of the library that eontains the existing 

I member. The default is the library name specified for prompt 2, 

I Display 2.0 SSP-ICF Conjuration Member Type 

I On display 2.0, specify the type of line member you want to define (or redefine). 



SSP-ICF CONFIGURATION MEMBER TYRE 


ASCLINE1 



Select one of the following options? 

1. INTRA 

2. BSC 

3. SNA 

4. Async 

I Option ... 1‘.4 4 


Cmd3^Previous display Cind7-End 


Cmd19-Cancel 



Select one of the following options: 

1 Intra creates an tntra subsystem member, This is the only type of 
configuration member for Intra; a line member is not used, 

2 BSC creates a line member or a subsystem member for BSC communications. 

3 SNA creates a line member or a subsystem member for communications using 
systems network architecture. 

4 ^ Async creates a line member or a subsystem member for asynchronous 

communications. 
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When you select option 4 Async and press the enter key, display 5.0 appears. On 
this display, you can select the type of asynchronous communications line member 
you want to work with. 



Async member type.. 1,2,3 

1. Async subsystem member 

2. Async line member 

3. Async/X.25 line member 


Cmdl9-Cancel 

COPR IBM Corp. 1986 



Async member type: Specify the type of asynchronous communications 
member you want to work with. Refer to the Using System/36 Asynchronous 
Communications Support manual for information on configuring an 
asynchronous communications subsystem (option 1 on display 5.0). If you 
select options 2 or 3, the display 12.1 appears. 
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Display 12.1 Async Line Member Attributes 


On display 12.1, enter information about the communications line that your 
asynchronous subsystem will use to communicate with a remote system. 



ASYNC LINE MEMBER ATTRIBUTES 


ASCLINE1 


W1 


1. Line rate (BPS). 

Choose one of the following; 


75 

1200 

150 

2400 

300 

4800 

600 

9600 


1200 


2. Type of parity 


1-None,2-Odd,3-Even 1 


3. Number of stop bits.1,2 1 

4. Number of retries. 1-255 016 

5. Wait time for 

acknowledgment (seconds) . 1-65535 00010 


Cmd3-Previous display Cmd7-End Cmdl9-Cancel 



1. Line rate (BPS): This prompt is not displayed for asynchronous/X.25 line 
members. Specify the line speed in bits per second. The default is 1200. 

2. Type of parity: This prompt is not displayed for asynchronous/X.25 line 
members. Specify the type of parity for error checking (a parity bit is a binary 
check digit inserted in each byte of data to make the arithmetic sum of all the 
digits, including the parity bit, always odd or always even). Enter a 1 for no 
parity, a 2 for odd parity, or a 3 for even parity. The parity that you specify 
must be the same as that specified by the remote station. The default is 1. 

3. Number of stop bits: This prompt is not displayed for asynchronous/X.25 line 
members. Specify the number of bits to be added to the end of each character. 
These bits are used to keep the local and remote ends of the line synchronized. 
The remote system must use the same number of stop bits as you specify here. 
Valid values are 1 or 2. The default is 1. 

4. Number of retries: Specify the number of times that System/36 will attempt to 
send or receive after an error has occurred before that error is considered 
permanent. This value applies only while you are using the file transfer 
subroutines. Enter a value from 1 through 255. The default is 16. 

5. Wait time for acknowledgment: Specify the length of time in seconds that 
System/36 will wait for an acknowledgment of a transmission before posting 
an error. This value applies only while you are using the file transfer 
subroutines. Valid values are from 1 through 65535. The default is 10. 
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1 Display 12.2 Async Line Member Attributes 


I 


12.2 ASYNC LINE MEMBER ATTRIBUTES 

1. Full duplex ? . 

2. Local echo supported ? . 

3. Local XON/XOFF supported ? . 

4. Modem initialization command . 

5. Total number of remote systems . 

6. X.25 configuration member name . 


ASCLINE1 

Optional-* 



Y,N Y 
Y,N N 
Y,N N 


1-64 


Cmd3-Previous display Cmd7-End Cmdl9-Cancel 



1. Full duplex? This prompt is not displayed if you are defining an 
asynchronous/X.25 line member. Specify whether data will be sent between 
System/36 and the remote system in both directions at the same time (full 
duplex). Specify a Y for yes or an N for no. The default is Y. 

You must specify a Y for the full duplex prompt if you specify a Y for either 
the local echo supported prompt or the local XON/XOFF supported prompt. 

2. Local echo supported? This prompt is not displayed if you are defining an 
asynchronous/X.25 line member. Local echo causes System/36 to send back 
(echo) to the remote station all characters that it receives. Enter a Y or an N. 
The default is N. 

Specify an N if you use this line member for file transfer to another 
System/36. 

Specify a Y only if you are communicating with a remote terminal that requires 
echo. If you specify a Y for the local echo prompt, you must also specify a Y 
for the full duplex prompt, and the line rate (specified on display 12.1) should 
be 2400 bps or less. 

3. Local XON/XOFF supported? This prompt is not displayed if you are defining 
an asynchronous/X.25 line member. Local XON/XOFF causes the 
asynchronous communications line member to respond to the flow control 
characters XON and XOFF. If System/36 receives an XOFF character while 
sending data, it will automatically stop sending, and it will start sending data 
again only after receiving an XON character. Enter a Y or an N. The default 
is N. 

Specify an N if you use this line member to transfer files to another 
System/36. 

If you specify a Y for the local XON/XOFF prompt, you must also specify a Y 
for the full duplex prompt. 
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4. Modem initialization command: This prompt is not displayed if you are defining 
an as5mchronous/X.25 line member. Specify a character string to be sent to 
the modem to set the various modes or states for its operation. This character 
string is sent, exactly as entered, to the modem when the subsystem is enabled. 
See the modem documentation for the correct values. The default is no modem 
initialization data. 

5. Total number of remote systems: This prompt is displayed only if you are 
defining an asynchronous/X.25 line member. Enter a number from 1 through 
64 that is the total number of remote systems that will communicate with this 
line member. You define remote systems on display 12.5. If you define fewer 
remote systems than the number specified on this prompt, the CNFIGICF 
procedure assigns the remainder as generic remote systems. They are used for 
remote stations that call your system. The remote systems must also be 
defined using the DEFINLOC procedure command (see “Using the 
DEFINLOC Procedure” later in this chapter for more information). For 
generic remote systems, no remote network address is required for the virtual 
circuit configuration. 

The number that you specify for this prompt should be the sum of: 

a. The number of remote systems that your system will call (you will name 
these systems on display 12.5) 

b. The number of generic remote systems that you will allow to call your 
system at one time. 

6. X.25 contiguration member name: This prompt appears only if you are defining 
an asynchronous/X.25 line member (option 3 on display 5.0). Specify the 
name of the X.25 virtual circuit configuration member that is associated with 
this asynchronous/X.25 line member. This configuration member contains 
X.25 information for each remote system you configure. You must define this 
configuration member using the CNFIGX25 procedure after you define the 
asynchronous/X.25 line member. See “Configuring for X.25 Support” later in 
this chapter for a description of the CNFIGX25 procedure. The following 
figure shows the relationship between the members created by the CNFIGICF 
and CNFIGX25 procedures. 


CNFIGICF: 


CNFIGX25: 

Display 1.0 


Display 5.0 

Member Name 


Related RWS or 



Line Configuration 



Member 

Display 12.2 



X.25 Configuration 

- > 

Display 5.0 

Member 


(virtual circuit) 



Member Name 


AAA009-1 
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Display 12.5 Remote System Selection 


On display 12.5, enter information that defines the remote system. You may have 
to call someone at the remote location to get the remote system information. 

For an asynchronous subsystem, you need only to define the remote system name. 


12.5 


REMOTE SYSTEM SELECTION 


1. Select from the following options: 

1-Create 

4-Remove 

Options . 

2. Remote system name . 


ASCLINE1 



OPTION REMOTE SYSTEM OPTION REMOTE SYSTEM OPTION REMOTE SYSTEM 

+ 


+ 


Cmd7-End CmdS-Reset Cmdl9-Cancel Roll-Page 



On this display, you select the remote systems this subsystem communicates with. 
For an asynchronous line, you can define one remote system; for an 
asynchronous/X.25 line, you can define up to 64 remote systems. 

For an asynchronous/X.25 line, the remote systems which you define by name will 
be used for outgoing calls to remote systems. If you define fewer than the total 
number of remote systems (specified in prompt 5 on display 12.2), the system 
automatically defines the remaining number as generic remote systems, assigning 
numerical station addresses to them. These station addresses are used for incoming 
calls from remote systems. 

Note: Before your system can accept an incoming call from a remote system, you 
must list its location name and local ID using the DEFINLOC procedure 
command. See ‘‘Using the DEFINLOC Procedure” later in this chapter for 
more information. 

All previously defined remote systems are listed. You may remove any of these 
remote systems by entering the correct option number in the column to the left of 
the remote system with which you want to work. 

If no remote systems have been defined in the line member, the only option shown 
on display 12.5 is 1-Create. 
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1 Select from the following options: Specify which of the available options you 
want to use: 

1-Create defines a new remote system. 

4-Remove deletes a remote system. It will no longer exist in this member. 

2 Remote system name: Enter the name you are using to identify the remote 
system. Then when you create a subsystem member that will use this line 
member and you want to include this remote system in the communications 
network, enter this remote system name on the Select remote system name 
prompt on display 29.0. 

The plus signs (+) on the right side of the display indicate additional pages of 
remote systems. If a plus sign is on the top line, you can use the Roll Down key to 
display more remote systems at the top of the list. If a plus sign is on the bottom 
line, you can use the Roll Up key to display more remote systems at the bottom of 
the list. 


Conf^ng for X.25 Support 

This section describes how to define and maintain the X.25 environment for the 
asynchronous subsystem using X.25 protocol. 

For an overview of X.25 communications, see the manual Data Communications 
Concepts. 

This section assumes that you have already installed the asynchronous 
communications support and performed the CNFIGSSP and CNFIGICF 
procedures. 

To define and maintain the X.25 environment, you use the following X.25 
procedures. 

• CNFIGX25 Procedure (X.25 Configuration Utility): Defines the X.25 network 
configuration, logical channel configuration, and virtual circuit configuration. 

An asynchronous/X.25 line member is linked to an X.25 configuration 
member through common names. The member name specified on CNFIGICF 
display 1.0 during line member configuration must be the same as the Related 
RIFS' or line configuration member specified on CNFIGX25 display 5.0. Also, 
the X.25 configuration member specified on CNFIGICF display 12.2 must be 
the same as the virtual circuit Member name specified on CNFIGX25 display 
5.0. See the following figure. 
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CNFIGICF: 


CNFIGX25: 

Display 1.0 


Display 5.0 

Member Name 


Related RWS or 



Line Configuration 



Member 

Display 12.2 



X.25 Configuration 

< -► 

Display 5.0 

Member 


(virtual circuit) 



Member Name 


AAA009-1 


• DEFINLOC Procedure: Lets you create and maintain a list of the remote 
locations that are allowed to call your system. 

• MAINTX25 Procedure (X.25 Maintenance Utility): Displays information about 
the X.25 links and lets you change certain virtual circuit parameters for active 
X.25 configurations. 

Note: You perform the CNFIGX25, MAINTX25, or DEFINLOC procedures only 
for an asynchronous/X.25 configuration, which uses X.25 support to 
communicate with a remote station directly through a PSDN. You do not need 
to perform these procedures for an asynchronous configuration without X.25 
support. 

For more information on the MAINTX25 procedure, refer to Chapter 4, “Defining 

and Maintaining an X.25 Configuration.” 
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I Using the DEFINLOC Procedure 


You use the DEFINLOC procedure to set up a list of the names and location IDs 
of remote locations that you allow to call your subsystem (an asynchronous 
subsystem using X.25 support only). 

When your subsystem receives a connect request, the system checks the location ID 
of the calling system. If the location ID and location name are listed in 
DEFINLOC, the call is accepted; otherwise, the call is rejected. If the call is 
accepted, the remote system is connected through an available logical channel and 
assigned to a generic remote system. 

When you use the DEFINLOC procedure, you enter information on a set of 
displays. From the DEFINLOC Main menu, you can choose to look at a list of 
locations already entered, add new locations, change (update) existing locations, or 
delete locations. 


To start, enter the DEFINLOC procedure command, which has no parameters. 
The following menu appears: 




REMOTE LOCATION DEFINITION 


Select one of the following options; 

1. Display the remote locations 

2. Add remote locations 

3. Update remote locations 

4. Delete remote locations 


Option: 


Cmd7-End 




COPR IBM Corp. 1986 

__J 


Select an option and press the Enter key. For more information about how to use 
the DEFINLOC procedure, press the Help key from menu 1.0. You can also press 
the Help key for information about each DEFINLOC display. 
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I Chapter 12. File Transfer Subroutines 


The file transfer subroutines allow a user application program to send or retrieve 
entire data files and library members from one System/36 to another. Two 
subroutines exist: SUBRFl, for Assembler and COBOL programs, and SUBRF2, 
for RPG II programs. 

The file transfer subroutines (FTS) allow communications with the APPC, 
asynchronous communications, BSCEL, or Peer subsystems. FTS has a maximum 
user record length of 4075. Your subsystem must be configured accordingly. If 
the application program is communicating with: 

• APPC subsystem, the maximum request/response unit must be 4075. 

• Asynchronous communications subsystem, the maximum user record length 
must be 4075. 

• BSCEL subsystem, the block size must be 4075. 

• Peer subsystem, the maximum user record length must be 4075. 

The application program that calls the file transfer subroutines may either send a 
data file or library member or retrieve one from the remote location. The target 
system receives the file or library member. Thus, if system A in the figure below 
sends a data file to system B using the file transfer subroutines, system B is the 
target system; if system A retrieves a data file from system B using the file transfer 
subroutines, system A is the target system. 


System A System B 



S90S6005-0 
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I Calling the File Transfer Subroutines 


I Assembler 


I When you call the SUBRFl subroutine from an Assembler program, you must use 

I the EXTRN instruction to indicate that SUBRFl is an external subroutine. A 

I parameter list must be defined in the application program. The parameters must be 

I listed in the order in which they are listed under “File Transfer Subroutine 

I Parameters” later in this chapter. See the example that follows. 
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* 

ASSEMBLER MODULE MAIN CALLS FILE TRANSFER SUBROUTINE (SUBRFl) 


EXTRN 

SUBRFl 


MAIN 

* 

START 

X’OOOO’ 


* 

B 

SUBRFl 

Call file transfer subroutine 


DC 

AL2(PLIST) 

Parameter list 

* 



Control returns here after SUBRFl execution 

* 

4c 



Parameter list 

PLIST 

EQU 

4c 



DC 

AL2(SAVA) 

Address of save area 


DC 

AL2(FCODE) 

Address of first parameter 


DC 

AL2(QUAL1) 

Address of second parameter 


DC 

AL2(QUAL2) 

Address of third parameter 


DC 

AL2(QUAL3) 

Address of fourth parameter 


DC 

AL2(QUAL4) 

Address of fifth parameter 


DC 

AL2(QUAL5) 

Address of sixth parameter 


DC 

AL2(QUAL6) 

Address of seventh parameter 


DC 

AL2(REPL) 

Address of eighth parameter 


DC 

AL2(LOCNAM) 

Address of ninth parameter 


DC 

AL2(PWORD) 

Address of tenth parameter 


DC 

AL2(RCQDE) 

Address of eleventh parameter 


DC 

AL2(ERRMIC) 

Address of twelfth parameter 

ifc 

DC 

XL2’FFFF’ 

End of parameter list indicator 

* 

♦ 



Parameters 

FCODE 

EQU 

* 



DS 

XLl 


QUALl 

EQU 

4c 



DS 

XL8 


QUAL2 

EQU 

4c 



DS 

XL6 


QUAL3 

EQU 

4c 



DS 

XL8 


QUAL4 

EQU 

4t 



DS 

XL8 


QUAL5 

EQU 

4c 



DS 

XL6 


QUAL6 

EQU 

4t 



DS 

XL8 


REPL 

EQU 

4c 



DS 

XLl 


LOCNAM 

EQU 

4c 



DS 

XL8 


PWORD 

EQU 

4c 



DS 

XL4 


RCODE 

EQU 

4c 



DS 

XLl 


ERRMIC 

EQU 



4c 

DS 

XL8 


* 

4c 



Save area 

SAVA-DC-XLrBO’-Indicator byte—calling program is Assembler 


DC 

CL6’MAIN’ 

Calling program’s name 


END 

MAIN 
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1 COBOL 


The format for the call to the SUBRFl subroutine from a COBOL program is as 
follows: 

CALL ’SUBRFl’ USING FCODE,QUALl,QUAL2,QUAL3,QUAL4,QUAL5, 
QUAL6,REPL,L0CNAM,PW0RD,RC0DE,ERRMIC 

The parameters to be passed to the subroutine are described under “File Transfer 
Subroutine Parameters” later in this chapter. 


I RPGII 

I To call the SUBRF2 subroutine in an RPG II program, make the following entries 

I on the calculation specification: 



The parameters to be passed to the subroutine are described under “File Transfer 
Subroutine Parameters” later in this chapter. 
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I File Transfer Subroutine Parameters 


FCODE This 1-character field contains the file transfer function to be 
performed. This field is required. Valid values are as follows: 

S: Send a data file or library member to the remote system. 

R: Retrieve a data file or library member from the remote system. 

QUALl through QUAL6 

These six fields tell the system whether you want to transfer a data file 
or a library member. They also allow you to give the data file or 
library member a different name on the target system. 

General rules for naming data files, libraries, and library members are 
in the System Reference manual. 

Figure 12-1 shows the meanings of the qualifiers for data files. 

Figure 12-2 shows the meanings of the qualifiers for library members. 
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Qualifier 

Value 

Description 

QUALl 

File name 

The name of the data file (1 to 8 characters long). This field is required. Do not 
specify a group file name. 

QUAL2 

File date 

The 6-digit decimal field representing the creation date of the file. This field is 
optional. If you do not specify a file date and more than one file exists with the 
specified name, the most recent file is used. The format of the file date must be the 
same as your system date format. Make sure the system date format on the remote 
system is the same as the format on your system if you use this field. 

QUAL3 

Blank 

This field must be left blank. 

OUAL4 

Target file 
name 

The name of the data file (1 to 8 characters long) at the target system. This field is 
optional. 

• If you are replacing a file (REPL=Y), this is the name of the file to be replaced 
at the target system. 

• If you are adding a new file, this is the name to be assigned to the new file. 

• If you do not specify a target file name, the file name from QUALl is assumed. 

QUAL5 

Target file 
date 

The creation date (6 decimal digits long) of the file at the target system. This field 
is optional. The format of the file date must be the same as your system date 
format. Make sure the system date format on the remote system is the same as the 
format on your system if you use this field. 

• If you are replacing a file (REPL=Y), this is the creation date of the file to be 
replaced at the target system. 

• If you are adding a new file, this is the date to be assigned to the new file. 

• If you do not specify a target file date, the file date from QUAL2 is assumed. 

QUAL6 

Blank 

This field must be left blank. 


Figure 12-1. Qualifiers for Data Files 
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Qualifier 

Value 

Description 

QUALl 

Library 

name 

The name (1 to 8 characters long) of the library in which the member can be 
found. This field is required. 

QUAL2 

Library 

member 

type 

Valid values are SOURCE, PROC (procedure), LOAD, and SUBR (subroutine). 

This field is required. 

QUAL3 

Library 

member 

name 

The name of the library member (1 to 8 characters). This field is required. 

QUAL4 

Target 

library 

name 

The name (1 to 8 characters long) of the library in which the member is to be 
stored. This field is optional. If you do not specify a target library name, the value 
from QUALl is assumed. 

QUAL5 

Blank 

This field must be left blank. 

QUAL6 

Target 

library 

member 

name 

The name (1 to 8 characters long) of the library member at the target system. This 
field is optional. 

• If you are replacing a library member (REPL=Y), this is the name of the 
member to be replaced at the target system. 

• If you are adding a new library member, this is the name to be assigned to it. 

• If you do not specify a target library member name, the value from QUAL3 is 
assumed. 


Figure 12-2. Qualifiers for Library Members 
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REPL 


LOCNAM 

PWORD 

RCODE 

ERRMIC 


This 1-character field tells whether or not you want to replace the data 
file or library member on the target system. Valid values are as 
follows: 

Y: Replace an existing data file or library member on the target 
system. 

N: Do not replace an existing data file or library member; 
indicate an error condition to the user if the file or member 
already exists. 

The default is N. 

Note: If you specify REPL^ Y for a library member, the library 
containing that member cannot be used for any other 
operation during the replace operation. 

This 8-character name contains the name of the remote location with 
which you are communicating. This should be the same as the remote 
location name specified in display 30.0 of the CNFIGICF procedure 
(see the manual Using the Asynchronous Communications Support). 

This 4-character field contains the password for signing on the remote 
system. This field is required only if the remote system has password 
security active. 

This 1-character field contains the return code. The subroutine 
returns this value to the application program to indicate the result of 
the file transfer. Valid values are as follows: 

0: Normal completion. 

1: An error was detected at the local system. 

2: An error was detected at the remote system. 

For return codes 1 and 2, the specific error is logged to the history file 
of both systems, and the message identifier code (MIC) is returned to 
the user in the ERRMIC field. 

If the value returned in the RCODE field is 1 or 2 (indicating an 
error), then this 8-character field contains the MIC for the specific 
error, (see “File Transfer Subroutine Messages” in this chapter). 
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I File Transfer Subroutine Mess^es 


1 Messages returned by the file transfer subroutines contain the characters FTS as 

I the first three characters. Refer to the System Messages manual for messages not 

I listed here. 

I FTS —1001 FTS started with [location-name] 

I Severity: N/A 

I Auto Response: N/A 

I Explanation: The file transfer subroutine support has begun an SSP-ICF session 

I with the specified remote location. 

I FTS -1002 FTS ended with [location-name] 

I Severity: N/A 

I Auto Response: N/A 

I Explanation: The file transfer subroutine support has ended the SSP-ICF session 

I with the specified remote location. The transaction has completed normally. 

I FTS —1003 FTS ended due to error with [location-name] 

I Severity: N/A 

I Auto Response: N/A 

Explanation: The file transfer subroutine support has encountered an error which 
has caused the session with the remote system to be terminated. A previous 
message indicates the specific type of error encountered. 

I FTS —1004 FTS could not be started ([ICF retuin-code]) 

I Severity: N/A 

I Auto Response: N/A 

I Explanation: The file transfer subroutine support tri(3d to establish a session with a 

I remote system. However, the session could not be started. The SSP-ICF return 

I code given in the message indicates the specific error encountered. Refer to the 

I System Messages manual for a description of this return code. 
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FTS —1005 FTS canceled by system operator 
Severity: N/A 
Auto Response: N/A 

Explanation: A user application program running the file transfer subroutine has 
been canceled by an operator at the system console. The transaction with the 
remote system has abnormally ended. 

FTS —1006 Permanent session error ([ICF return-code]) 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support has encountered a permanent 
SSP-ICF session error. The session has abnormally terminated. The SSP-ICF 
return code given in the message indicates the specific error encountered. Refer to 
the System Messages manual for a description of this return code. 

FTS —1007 Remote system error ([error-MIC]) 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was communicating with a 
remote system and received an indication that the remote system detected an error. 
The session has been terminated. The specific error detected is given in the 
message and refers to the error message displayed at the remote system. Refer to 
the appropriate message guide to get a description of the error that caused the 
remote system to terminate the session. 

FTS —1008 #FTS cannot be started from the job queue/display station 

Severity: N/A 
Auto Response: N/A 

Explanation: The IBM-supplied procedure #FTS can only be run through the use 
of the file transfer subroutine support. Any other use causes unpredictable results. 
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FTS “1009 #FTS cannot be evoked by a user application 
Severity; N/A 
Auto Response: N/A 

Explanation: The IBM-supplied procedure #FTS can only be evoked through the 
file transfer subroutine support. A user cannot try to explicitly evoke this 
procedure. 

FTS “1010 Received [dataset name] FROM [location-name] 

Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support on your system has successfully 
received a file or library member from the specified remote location. This is either 
the result of a retrieve request by your system or a send request from another 
system. The name of the file or member in the message consists of one to three 
parts separated by commas. If the name has one or two parts, it is a file name; if 
the name has three parts, it is a member name. 

FTS —1011 Sent [dataset-name] to [location-name] 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support on your system has successfully 
sent a file or library member to the specified remote location. This transaction is 
either the result of a send request to a remote system, or a retrieve request received 
from a remote system. The name of the file or member in the message consists of 
one to three parts separated by commas. If the name has one or two parts, it is a 
file name; if the name has three parts, it is a member name. 
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FTS —1012 Error receiving [dataset-name] from [location-name] 

Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support encountered an error while 
receiving a file or library member from the specified remote location. A previous 
message indicates the specific error encountered. The file or member was not 
added or replaced on your system. The name of the file or member in the message 
consists of one to three parts separated by commas. If the name has one or two 
parts, it is a file name; if the name has three parts, it is a member name. 

FTS —1013 Error sending [dataset-name] to [location-name] 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support has encountered an error while 
sending a file or library member to the specified remote location. A previous 
message indicates the specific type of error encountered. The file or member was 
not completely sent. The name of the file or library member in the message 
consists of one to three parts separated by commas. If the name has one or two 
parts, it is a file name; if the name has three parts, it is a member name. 

FTS —1014 FTS has abnormally termmated 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine has abnormally terminated. A previous 
message indicates the specific error encountered during the SSP-ICF session. The 
session has been terminated. 

FTS —1020 [function-code] is an invalid function code 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support detected an invalid function code 
passed by a user program. The invalid code is given in the message. Valid codes 
are S for send a file or member, and R for retrieve a file or member. All other 
codes are considered invalid. The request was rejected and the session terminated. 
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FTS —1021 [file-name] is an invalid file name 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support detected an invalid file name 
given as the first or fourth qualifier on a send or retrieve file request. This means 
either the file name contained characters other than A through Z, 0 through 9, #, $, 
or &; or the first character of the file name is not alphabetic (A through Z, #, $, 
or @). Also, the file name cannot be the word ALL. The request was rejected 
and the session terminated. 

FTS —1022 [library-name] is an invalid library name 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support detected an invalid file name 
given as a first qualifier on a send or retrieve file request. This means either the file 
name contained characters other than A through Z, 0 through 9, #, $, or &; or 
the first character of the file name is not alphabetic (A through Z, #, $, or (g)). 
Also, the file name cannot be the word ALL. The request was rejected and the 
session terminated. 

FTS —1023 [file-date] is an invalid ffle date 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support detected an invalid file date given 
as the second or fifth qualifier on a send or retrieve file request. A valid file date is 
six numeric digits in your system date format. The request was rejected and the 
session terminated. 

FTS —1024 [member-type] is an invalid member type 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support detected an invalid member type 
given as the second qualifier on a request to send or retrieve a library member. 

The second qualifier specifies the library member type and must be either 
SOURCE for source members, PROC for procedure members, LOAD for load 
members, or SUBR for subroutine members. The request was rejected and the 
session terminated. 
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FTS —1025 [member-name] is an invalid member name 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support detected an invalid library 
member name given as the third or sixth qualifier on a send or retrieve library 
member request. This means that either the library member name contains 
characters other than A through Z, 0 through 9, #, $, or &; or the first character 
of the library member name is not alphabetic (A through Z, #, $, or @). Also, the 
library member name cannot be the reserved words ALL, DIR, NEW, or SYSTEM. 
The request was rejected and the request terminated. 

FTS —1026 [replace-option] is an invalid replace option 

Severity: N/A 

AutoRe^onse: N/A 

Explanation: The file transfer subroutine support detected an invalid replace option 
passed by a user program. The invalid option is given in the message. Valid 
options are Y for replace existing file or member, and N for do not replace an 
existing file or member. If no value was given, N will be used as the default option. 
The request was rejected and the session terminated. 

FTS —1027 Cannot send folder [folder-name] 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to send a file to a 
remote system. However, the name specified in the message is the name of a 
folder, and the file transfer subroutine does not support the sending of folders. The 
session has been terminated. 

FTS —1028 Cannot replace folder [folder-name] 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to replace a file on 
your system. However, the name specified in the message is the name of a folder 
on your system, not a file. The file transfer subroutine does not allow a folder to 
be replaced by a file. The session has been terminated. 
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FTS —1029 Cannot send remote file (file-namej 
Severity; N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to send a file to a 
remote system. However, the file specified in the message does not exist on your 
system; it is identified in your system’s network resource directory as a remote file. 
The file transfer subroutine does not support the sending of remote files. The 
session has been terminated. 

FTS —1030 File [file-name] already exists 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a file 
from a remote system. However, the file specified in the message already exists on 
your system, and the REPLACE-Y option has not been specified for this 
transaction. The session has been terminated. 

FTS —1031 File (fUe-name] is in use 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to either send a file 
to a remote system or replace a file on your system. However, the file specified in 
the message is currently being updated by another program. The session has been 
terminated. 

FTS —1032 Not enough space to create fOe [file-name] 

Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a file 
from a remote system. However, there is insufficient disk space to create the file 
specified in the message. The session has been terminated. To create more disk 
space on your system, you can run the COMPRESS procedure to create more 
contiguous space, delete unneeded files, or save seldom used files on diskette. 
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FTS —1033 VTOC is full; cannot create file Ifile-name] 

Severity; N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a file 
from a remote system. However, the disk VTOC is full, and the file specified in 
the message cannot be added to your system. The session has been terminated. To 
make room for new files, you can save seldom used files on diskette and delete 
them from disk, or run the CNFIGSSP procedure to increase the number of VTOC 
entries allowed on your system. 

FTS —1034 User [user-IDl not authorized to access file Ifile-namel 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to either send a file 
to a remote system or replace a file on your system. However, the user specified in 
the message is not allowed to use the file. The session has been terminated. 

FTS —1035 File [file-name] cannot be allocated ([error-MICD 

Severity; N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested either to send a file 
to a remote system or to receive a file from a remote system. However, the file 
specified in the message could not be allocated. The session has been terminated. 
The code in the message refers to a system message number indicating the specific 
error encountered during file allocate. Refer to the System Messages manual for a 
description of this error. 

FTS —1036 File [file-namel not found 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to send a file to a 
remote system. However, the file cannot be found on your system. The session 
has been terminated. 
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FTS —1037 File [file-name] cannot be opened ([error-MICD 
Severity; N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested either to send a file 
to a remote system or to receive a file from a remote system. However, the file 
specified in the message cannot be opened. The session has been terminated. The 
code in the message refers to a system message number indicating the specific error 
encountered during file open. Refer to the System Messages manual for a 
description of this error. 

FTS —1038 Disk error while opening file [file-namel 
Severity; N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested either to send a file 
to a remote system or to receive a file from a remote system. However, the file 
specified cannot be opened because a disk I/O error occurred during disk file open. 
The session has been terminated. Use the BUILD procedure to try to correct the 
error on disk. 

FTS “1039 Cannot send library [library-namel 
Severity; N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to send a file to a 
remote system. However, the name specified is a library on your system, not a file. 
The file transfer subroutine does not send libraries. The session has been 
terminated. 

FTS —1040 Cannot send alternative index file [file-namel 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to send a file to a 
remote system. However, the file specified in the message is an alternative index 
file, and the file transfer subroutine does not send this type of file. The session has 
been terminated. 


Chapter 12. File Transfer Subroutines 


12-17 



FTS —1041 Disk error while creating file [file-name] 

Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a file 
from a remote system. However, a disk I/O error occurred while writing to this 
file. The session has been terminated. If a new file was being added to your 
system, the partial file was deleted. If a file was being replaced, only part of the 
file was replaced. 

FTS —1042 Disk error while readii^ file [file-name] 

Severity; N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to send a file to a 
remote system. However, a disk I/O error occurred while the file was being read. 
The file was not completely sent, and the session was terminated. Use the BUILD 
procedure to try to correct the error on disk. 

FTS —1043 FOe [ffle-name] is full 

Severity; N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to replace a file on 
your system. However, the file became full before all data could be replaced. This 
means either the file was not extendable or there was not enough disk space to 
extend the file. The session has been terminated. You can run the COMPRESS 
procedure to create more contiguous disk space, delete unneeded files, or save 
seldom used files on diskette. To correctly replace the file, delete the file being 
replaced on your system, and let your remote system attempt to replace it again. 

FTS —1044 Record length for file [file-name] does not match definition 

Severity; N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a file 
from a remote system. However, the file specified in the message is externally 
described and the file’s record length is different from the record length specified 
by the file definition in the dictionary. The record length of the file must match the 
file definition in order for the file to be linked to its associated dictionary. The 
session has been terminated. 
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FTS -1045 


File level for fUe [file-name] does not match definition 


Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a file 
from a remote system. However, the file specified in the message is externally 
described and the change level of the file definition differs from the change level of 
the definition at the source system. This means that the definition or dictionary at 
your system has been changed in some way that does not match that of the source 
system. The session has been terminated. 

FTS —1046 Dictionary or definition not found for file [file-name] 

Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested either to send a file 
to a remote system or to receive a file from a remote system. However, the file 
specified in the message is externally described and its dictionary or file definition 
was not found on the system. When an externally described file is sent by file 
transfer to a remote system, its associated dictionary name and file definition name 
are also sent. When this type of file is received, it is automatically linked to the 
same dictionary and file definition. Because the file could not be linked to its 
associated dictionary or definition, the session has been terminated. 

FTS —1047 Dictionary or definition is in use for fUe [file-name] 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a file 
from a remote system. However, the file specified in the message is externally 
described and its dictionary or file definition is currently being updated by another 
program. When this type of file is received, it is automatically linked to its 
dictionary and file definition, and it requires dedicated use of these resources. The 
session has been terminated. 
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FTS --1048 Dictionary for file [file-name] cannot be opened [MlC-number] 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a file 
from a remote system. However, the file specified in the message is externally 
described and its dictionary could not be opened. The session has been terminated. 
The code in the message refers to a system message number indicating the specified 
error encountered while the system was trying to open the dictionary. Refer to the 
System Messages manual for a description of this error. 

FTS —1049 File [file-name] exists as a remote file 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a file 
from a remote system. However, the file specified in the message does not exist on 
your system; it is identified in your system’s network resource directory as a remote 
file. A local file cannot be created with the same name as a file defined at your 
system as a remote file. Also, the file transfer subroutines cannot replace a file 
defined as a remote file on your system. The session has been terminated. 

FTS —1050 Library [library-name] not found 

Severity: N/A 

Auto Response: N/A 

Explanation: The file transfer subroutine support was requested either to send a 
library member to a remote system or to replace a library member on your system. 
However, the library name specified for the transaction could not be found on your 
system. The session has been terminated. 

FTS —1051 User [user-ID] not authorized to access library [library-name] 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested either to send a 
library member to a remote system or to replace a library member on your system. 
However, the user specified in the message is not allowed to use this library. The 
session has been terminated. 
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FTS ~I052 [member-typej-fmember-namel ab-eady exists in Hbrary 
[library-name] 

Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a library 
member from a remote system. However, the member of the specified type already 
exists in this library, and the REPLACE-Y option has not been specified for this 
transaction. The session has been terminated. 

FTS —1053 [member-type]-[member-name] not found in library [library-name] 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to send a library 
member to a remote system. However, the member of the specified type was not 
found in this library. The session has been terminated. 

FTS —1054 Not enoi^h space in library [library-name] to create 
[MEMBER-TYPE]-[MEMBER-NAME] 

Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a library 
member from a remote system. However, there is not enough disk space allocated 
for this library to add the member. The session has been terminated. You can 
make more space available by removing unnecessary members using the REMOVE 
procedure and then running the CONDENSE procedure, or by increasing the space 
allocated for this library with the ALOCLIBR procedure. 

FTS —1055 Directory full; cannot create [member-type]-[member-name] in 

library [LIBRARY-NAME] 

Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to receive a library 
member from a remote system. However, there is not enough space in the library 
directory to contain the entry for the member given in the message. The session 
has been terminated. You can make more space available in the directory either by 
removing unnecessary members using the REMOVE procedure or by increasing 
the directory size using the ALOCLIBR procedure. 
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FTS --1056 [member-typel-lmember-name] in library [library-name] is in use 
Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested either to send a 
library member to a remote system or to replace a library member on your system. 
However, the member of the specified type in the message is currently being 
updated by another program. The session has been terminated. 

FTS —1057 [member-typel-[member-namel in library [library-namel IS AN 
IBM MEMBER 

Severity: N/A 
Auto Response: N/ A 

Explanation: The file transfer subroutine support was requested to send a library 
member to a remote system. However, the file transfer support does not allow the 
sending or receiving of IBM-supplied members. The session has been terminated. 

FTS —1058 Disk error whUe opening [member-type]-[member-name] in library 
ILIBRARY-NAMEI 

Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to send or receive 
a library member from a remote system. However, a disk error occurred while the 
system was reading the directory of the member in the specified library. The 
session has been terminated. The disk could be defective, or there could be a 
problem in the disk 1/O control handler. The library cannot be used with an error 
in the directory. You should rebuild the library using the RELOAD or RESTLIBR 
procedure if it is the system library, or the BLDLIBR or RESTLIBR procedure if it 
is a user library. 

FTS —1059 Disk error while clos^ [member-type]-[member-namel in library 
ILIBRARY-NAMEJ 


Severity: N/A 
Auto Response: N/A 

Explanation: The file transfer subroutine support was requested to send or receive 
a library member from a remote system. However, a disk error occurred while the 
system was writing the directory of the member in the specified library. The 
session has been terminated. The disk could be defective, or there could be a 
problem in the disk 1/O control handler. The library cannot be used with an error 
in the directory. You should rebuild the library using the RELOAD or RESTLIBR 
procedure if it is the system library, or using the BLDLIBR or RESTLIBR 
procedure if it is a user library. 
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Appendix A. X.25 Network Types by Country 


The following table shows, by country and network, the network type to specify on 
display 2.0, X.25 Network Configuration, when defining a network and logical 
channel configuration using the CNFIGX25 procedure. Refer to Chapter 4 for 
information on CNFIGX25. 


For any network not shown in the table, specify network type A. 


Country 

Network 

TVpe 

Australia 

AUSTPAC 

D 

.Belgium 

DCS 

D 

Denmark 

DATAPAK 

C 

Israel 

ISRANET 

C 

Italy 

ITAPAC 

D 

Japan 

DDX-P 

B 

Mexico 

TELEPAC 

C 

Norway 

DATAPAK 

C 

Singapore 

TELEPAC 

D 

United Kingdom 

SWITCHSTREAM 1 

C 

United States 

TELENET 

C 
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Appendix B. Considerations for CICS/VS and Systeni/38 


This appendix discusses the considerations needed to use System/36 APPC to 
communicate with a system that is running CICS/VS or with a System/38. The 
information is shown in a format familiar to the other system (CICS/VS or 
System/38). If you are intending to use System/36 APPC to communicate with a 
Display writer or another System/36, the information provided in 
Chapter 3, “Configuring for Communications” and Chapter 9, “Configuring for 
Advanced Program-to-Program Communications” should suffice. 


ACF/NCP/VTAM Generation Considerations 

ACF/NCP/VTAM generation consists of defining the parameters for peer to NCP 
transfers and NCP-to-System/36 (logical unit) transfers. The macroinstructions 
used for the definitions are GROUP, LINE, SERVICE, PU, and LU. The GROUP 
macroinstruction defines the characteristics of the nonswitched lines connected to 
the system; the LINE macroinstruction defines the characteristics for a particular 
line; the SERVICE macroinstruction defines the order in which the lines are to be 
serviced; the PU macroinstruction defines the physical unit; and the LU 
macroinstruction defines the logical unit sessions that can be active from the 
associated physical unit. 

The nonswitched line and switched line considerations are presented separately. 

When you define CICS to ACF/VTAM, you should include the following options 
on the VTAM APPL statement: 

CICS APPL AUTH=(ACQ,VPACE),MODETAB=LOGMOD36,VPACING=7 

AUTH=(ACQ,VPACE) ACQ is required to allow CICS to acquire LUTYPE 6 
sessions. VP ACE specifies that pacing is allowed for the intersystem flow. 

MODETAB=:LOGMOD36 specifies the LOGMODE table to be used to associate 
each mode name with a set of parameters for the session to CICS/VS. 

VPACING=7 specifies the maximum number of normal flow requests that another 
logical unit can send on an intersystem session before a response is required. 

Too low a value for VPACING can cause poor throughput because of the number 
of line turnarounds required; too high a value can cause excessive storage 
requirements. 
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ACF/NCP/VTAM Generation for Nonswitched Lines 


Defining the GROUP Macroinstruction for NCP/VTAM 

The GROUP macroinstruction defines characteristics of the type of 
communications that are to occur between NCP/VTAM and any of the attached 
physical units and logical units. The following illustrates an example of the 
GROUP macroinstruction as used for the System/36 definition; 

SAMPGRP GROUP LNCTL=SDLC, 

CLOCKING=EXT, 

DIAL=NO, 

DISCNT=NO, 

DUPLEX=HALF, 

ISTATUS=INACTIVE, 

MAXDATA=265, 

MAXOUT=7, 

MODE=PRIMARY, 

NRZI=YES, 

PACING=(7,1), 

PASSLIM=7, 

POLLED=yES, 

PUTYPE=2, 

RETRIES=(5,1,2), 

SPEED=9600, 

SSCPFM=USSSCS, 

TYPE=NCP, 

USE=NCP, 

VPACING=8 

LNCTL==SDLC defines the type of line control that is to be used for this group. 
For APPC communications with a System/36, this value is always SDLC. 


CLOCKING=EXT/INT specifies whether the modem or the system provides the 
data clock for the line. CLOCKING=EXT indicates that the modem must provide 
the data clocking; CLOCKING=INT specifies that the system must provide the 
data clocking. 

DIAL=YES/NO defines the type of line as being a switched line (YES) or a 
nonswitched line (NO). The value specified here must correspond to the value 
entered for the Line type prompt on display 12.0 during System/36 line member 
configuration. If DIAL=YES is specified, 2 must be entered for the Line type 
prompt. If DIAL=NO is specified, 1 must be entered for the Line type prompt. 

DISCNT=YES/NO specifies whether VTAM is to disconnect the physical unit 
when the last logical session ends. DISCNT=NO allows the communications link to 
remain active when no logical sessions are active; the physical unit is deactivated 
when the System/3 6 terminates the communications link. A session is terminated 
by the System/3 6 when ended by the user program. The communications link is 
terminated by the System/36 when a DISABLE procedure command ends 
communications. 

DISCNT=YES indicates that when no sessions are active on the line (physical 
unit), NCP will automatically terminate the communications link. 
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DUPLEX=HALF/FULL specifies whether communications is to occur in a 
half-duplex or full-duplex mode. For the System/36, this parameter is specified as 
DUPLEX=HALF. 

ISTATUS=ACTIVE/INACTIVE specifies whether the physical unit should be 
activated when the major node is activated (ISTATUS=ACTIVE) or activated by 
an operator command (ISTATUS=INACTIVE). 

MAXDATA=265 specifies the maximum amount of data, including the 
transmission header and request/response header, that the physical unit can 
receive. The value specified, 265, defines a 256-byte buffer plus 9 bytes for the 
transmission header and request/response header. 

MAXOUT=x specifies the number of frames that NCP will send to the System/36 
before an SDLC response is requested. A value of 1 specifies that a response is 
required after every frame; a value greater than 1 specifies that no response is 
required until that number of frames have been sent. This value can affect 
performance on the communications link. A value of 7 is recommended to 
optimize performance; but a value less than 7 may be required due to buffer 
limitations at the system or a high line-error rate. 

MODE=PRIMARY specifies that this is to be the primary station. 

MODETAB=LOGMOD36 specifies the name of the LOGMODE table to be used 
for APPC. For System/36 APPC to CICS/VS communications, the session group 
name defined at the System/36 on display 42.0 (Session Group Selection) must 
have a matching MODEENT entry in the VTAM LOGMODE table. The 
following illustrates a LOGMODE table with one entry for APPC: 

LOGMODE36 MODETAB 

SAMPMODE MODEENT LOGMODE=SAMPMODE 
MODEEND 

Note that CICS does not use the bind-image part of any VTAM LOGMODE entry 
for APPC. 

NRZI=YES/NO specifies whether the non-return-to-zero inverted data 
transmission method is to be used. The value specified for the NRZI parameter in 
the SETCOMM procedure command on the System/36 must match the value 
specified here. 

PACING=count specifies how pacing is to be handled between NCP and all logical 
units in this group. The value specified here can affect performance of the 
communications link. It also depends on the amount of buffer space available at 
the system. 

The value specified here should be the same as the value specified for the Receive 
pacing value prompt on display 44.0 (APPC Session Group Additional Options) 
during subsystem configuration at the System/36. 
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PASSUM=value specifies how many frames are to be sent to a station before NCP 
goes to the service order table to service one of the other stations on the line. 
PASSLIM and MAXOUT parameters work in conjunction to determine how 
frames are passed to a station. MAXOUT specifies how many frames are to be 
sent to a station before an SDLC response is requested. For example, if 
MAXOUT is 7, NCP will send seven frames to the station before a response is 
required. If PASSLIM is 2, NCP will send two frames to the station and then go to 
the service order table to service another station. Once seven frames have been 
sent to the first station, a response is requested from that station. 

POLLED=YES/NO specifies whether NCP is to poll the physical units within this 
group. YES is specified for the nonswitched line example. 

PUTYPE=2 specifies the type of physical units that are included in the group. 
Physical unit type 2 is required for the System/36. 

RETRIES=(value) specifies the number of transmission error retries that are to be 
attempted. 

SPEED=value specifies the minimum line speed in bps that is acceptable for this 
group. 

SSCPFM=USSSCS specifies what type of messages will be used to communicate 
with VTAM. SSCPFM=USSSCS specifies character-coded messages using SCS 
characters as delimiters. 

TYPE=NCP specifies the type of network control. 

USE=NCP specifies that NCP is controlling the network. 

VPACING=value specifies the rate of flow between the system and NCP. Based 
on the VPACING value, VTAM provides pacing to control the rate of flow 
between the system and NCP for a given logical unit. This value prevents NCP 
from being overloaded by path information units (PIUs) for a given LU when NCP 
is restricted as to how fast PIUs can be transmitted on the link. The value specified 
for VPACING is dependent on the rate of pacing between the NCP and remote 
LU and the speed of the link. 

Defining the LINE Macroinstruction for NCP/VTAM 

The LINE macroinstruction is used to define the characteristics of a line within a 
group during NCP/VTAM generation. The following is an example of a LINE 
macroinstruction used to define a line to a System/3 6 during NCP/VTAM 
generation. 

SAMPLNE LINE ADDRESS=028, 

PUTYPE=2, 

SPEED=9600, 

ISTATUS=INACTIVE 

ADDRESS=value specifies the local address of the line for NCP/VTAM (the 3705 
LIB address). 
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PUTYPE=2 specifies the type of physical units that are supported on the line. For 
APPC communications with a System/36, specify PUTYPE=2. 

SPEED=vaIue defines the minimum speed in bps for the line. 

ISTATUS=ACTIVE/INACTIVE specifies whether the line is to be activated when 
the NCP major node is activated (ISTATUS=ACTIVE) or activated by operator 
command (ISTATUS=INACTIVE). 

Definite the SERVICE Macroinstniction for a Multipoint Line 

The SERVICE macroinstruction defines the order in which multiple devices on a 
multipoint line are to be serviced. This macroinstruction applies only if the 
System/3 6 is a station on a multipoint line and the line type parameter of the 
SETCOMM procedure command specified MULTTRIB for the the System/3 6 
communications line. The following is an example of the SERVICE 
macroinstruction: 

SERVICE ORDER(SAMPPUA,SAMPPUB,...,SAMPPUX) 

The SERVICE macroinstruction has only one parameter: ORDER, A sequence is 
defined for each multipoint line, with the order being a list of the names of the 
stations (physical units) in the order they are to be serviced. The list can be 
constructed in a manner that favors the more active stations on the line by 
specifying that station’s name more than once in the list. 

Defining the PU (Physical Unit) Macroinstniction for NCP/VTAM 

The System/36 must be defined during NCP/VTAM generation. Each 
communications line from the System/36 to the system is considered, by the 
system, to be a physical unit and requires a physical unit definition in the 
NCP/VTAM generation. The PU macroinstruction is used during NCP/VTAM 
generation to define the physical units. The following is an example of the PU 
macroinstruction as used to define the System/36. 

SAMPPUA PU ADDR=C1 

ADDR=xx specifies the SDLC station address of the System/36. The value 
specified here, as two hexadecimal digits, must be unique within the physical units 
definitions at the system. This value is used as the Local system^s station address 
(prompt 5 on display 12.0, SNA Line Member Attributes) during line member 
configuration at the System/36. 

Defining the LU (Logical Unit) Macroinstniction for NCP/VTAM 

Each communications session with NCP/VTAM corresponds to an SNA logical 
unit. A logical unit definition in the NCP/VTAM generation is required for each 
session. The following is an example of the LU macroinstruction as it applies to 
the System/36: 

SAMPAPPC LU LOCADDR=01 

LOGAPPL=CICS 
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LOCADDR=address specifies the local address of the session and is equivalent to a 
logical unit number. The value entered here identifies the logical unit that is to be 
assigned to APPC on display 14.0 (Remote System Logical Unit Assignments) 
during line member configuration at the System/36. 

LOGAPPL=CICS specifies that the name of the system that the logical unit will be 
attached to is CICS. This parameter is required for APPC because the explicit 
LOGON used for SNUF does not apply. This parameter tells VTAM that the 
logical unit being defined will communicate with CICS. 


ACF/NCP/VTAM Generation for Switched Lines 


The following is an example of generating ACF/NCP/VTAM for use with a 
System/36 on a switched line network. The first macroinstruction statement, 
VBUILD, must be specified as VBUILD=SWNET. Also note that the IDBLK and 
IDNUM parameters (in the PU macroinstruction) must be specified since this is a 
switched line. 

SAMPSWA VBUILD TYPE=SWNET, 

MAXNO=5, 

MAXGRP=5 

SAMPPUA PU ADDR=C1, 

BATCH=NO, 

DISCNT=NO, 

IDBLK=03E, 

IDNUM=42721, 

MAXDATA=521, 

MAXOUT=7, 

PACING=(7), 

PASSLIM=7, 

PUTYPE=2, 

ISTATUS=ACTIVE, 

MODETAB=LOGMOD36, 

SSCPFM=USSSCS, 

VPACING=(7) 


SAMPAPPC 

LU 

LOCADDR=1, 
ISTATUS=ACTIVE 

SAMPLU2 

LU 

LOCADDR=2, 
ISTATUS=INACTIVE 

SAMPLU3 

LU 

LOCADDR=3, 
ISTATUS=INACTIVE 

SAMPLU4 

LU 

LOCADDR=4, 


ISTATUS=INACTIVE 

The following describes the parameters within the PU macroinstruction that are 
unique for a switched line. Those parameters with the PU macroinstruction that 
are the same as for a nonswitched line are not described. In addition, the 
parameters for the LU macroinstruction are not described since they are the same 
as for a nonswitched line. 


1DBLK=03E and IDNUM=number make up the SDLC exchange ID. These 
parameters are specified only for a switched line. The IDBLK is always 03E for 
System/36. The value specified here for IDNUM must match the value specified 
for prompt 6, Local system’s station XID in hexadecimal, on display 12.0 during 
System/36 line member configuration. 
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CICS/VS APPC Generation Considerations 


When a CICS/VS system is generated to communicate with a System/36 using 
APPC, entries must be placed in four tables to define the System/36 as a APPC 
system. These tables are the terminal control table (TCT), program control table 
(PCX), processing program table (PPT) and the system initialization table (SIT). 

In addition to the tables, certain options must be included for CICS/VS so that it 
can communicate with System/36 APPC. The following must be specified: 

DFHSG TYPE=INITIAL,VTAM=YES 

DFHSG PROGRAM=TCP,ACCMETH=VTAM,VTAMDEV=LUTYPE6 
DFHSG PROGRAM=EIP 
DFHSG PROGRAM=ISC 

Terminal Control Table (TCT) 

The terminal control table contains the information used by CICS/VS to define the 
remote system or terminal. 

The following is an example of the DFHTCT macroinstruction used to define the 
terminal control table for CICS/VS to System/36 APPC communication: 

DFHTCT TYPE=SYSTEM, 

TRMTYPE=LUTYPE62, 

ACCMETH=VTAM, 

SYSIDNT=S36I, 

FEATURE=SINGLE, 

CONNECT=AUTO, 

MODENAME=SAMPMODE, 

NETNAME=SAMPAPPC, 

RUSIZE=256, 

BUFFER=256, 

TRMSTAT=(TRANSCEIVE) 

TYPEssSYSTEM specifies that the definition is for an attached system, not 
necessarily an APPC system. 

TRMTYPE=LUTYPE62 specifies that the attached system will use APPC 
peer-to-peer communications. 

ACCMETH=VTAM specifies that the access method used is VTAM (Virtual 
Telecommunications Access Method). 

SYSIDNT=S36I specifies a one to four character alphameric name to identify the 
remote APPC system to CICS/VS. 

FEATURE=SINGLE specifies that only single session support is generated for this 
APPC system. 

CONNECT=AUTO specifies that CICS/VS will attempt to bind the single session 
when CICS/VS is initialized. CICS/VS attempts to bind as the contention winner, 
but will accept a negotiation to contention loser. This negotiation is done by the 
System/3 6 if 1 is specified for the Number of locally controlled sessions prompt on 
display 43.0, APPC Session Group Definition, during subsystem member 
configuration. 
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MODENAME-SAMPMODE specifies a one to eight character mode name to be 
used with this single session. The name will be passed to ACF/VTAM as the 
LOGMODE name. On the System/36 this name is specified as the Session group 
name prompt on display 42,0, Session Group Selection, during subsystem member 
configuration at System/36. You must not, however, use the reserved name 
SNASVCMG. 

NETNAMEssSAMPAPPC specifies a one to eight character network name to 
identify the remote APPC system to ACF/VTAM. On the System/36 this name is 
specified for the Location name prompt on display 22.0, Subsystem Member 
Definition. 

RUSIZE=256 specifies the size to be used to receive the request/response unit 
(RU) from the remote APPC system. On the System/36, the request unit size is 
specified by the Maximum receive RU size prompt on display 44.0, APPC Session 
Group Additional Options. System/3 6 supports from 8 through 4096. 

BUFFER=256 specifies the size of the request/response unit (RU) to be used to 
receive the request unit from the remote APPC system. 

TRMSTAT=(TRANSCEIVE) specifies that the APPC system can both transmit 
and receive data from the CICS/VS system. 

Note: The DFHTCT TYPE—SYSTEM macroinstruction has several additional 
parameters (not shown above) which are not necessary for CICS/VS to 
System/36 APPC communications. CHNASSY, INDSYS, RECEIVE, 
SEND and TIOAL should not be coded for APPC communications. 


Program Control Table (PCT) 

The program control table contains the information to be used by CICS/VS for 
identifying and initializing a transaction. This table is required by CICS/VS to 
verify the incoming transaction request. 

The following are examples of the DFHPCT macroinstructions used to define the 
program control table for CICS/VS for System/36 APPC communication: 

DFHPCT TYPE=ENTRY, 

TRANSID=SAMP, 

PROGRAM=TESTPROG 

TYPE=ENTRY specifies a transaction entry to the CICS/VS system. 

TRANSID=SAMP specifies a one to four character transaction name which the 
remote APPC program may evoke. If the remote program attempts to evoke a 
name longer than four characters, CICS/VS will only use the first four characters 
to determine which transaction to start. The remaining characters will have no 
meaning to CICS/VS, but may be retrieved by the CICS/VS application using an 
EXTRACT PROCESS command and used for application defined purposes. 
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PROGRAM*TESTPROG specifies a orie to eight character program name that 
relates to the program name in the processing program table (PPT). This name is 
not known to the remote APPC program. 

DFHPCT TYPE=PROFILE, 

PROFILE=S36PROF1, 

MODENAM=SAMPMODE 

TYPE=PROFILE specifies a profile to be used for APPC sessions. This is not a 
required field; you can use the system default. 

PROFILE*S36PROF1 specifies a profile name that will be used in the 
ALLOCATE command by CICS/VS transactions. 

MODENAM*SAMPMODE specifies the mode name that will be used with 
sessions that use this profile. On the System/36 this name is specified for the 
Session group name prompt on display 42.0, Session Group Selection, during 
subsystem member configuration. 

DFHPCT TYPE=GROUP 
FN=(ISC) 

TYPE=GROUP specifies a group entry to the CICS/VS system. 

FN*(ISC) specifies the generic function name that generates the required entries 
for intercommunication support. 

Processing Program Table (PPT) 

The processing program table allows you to describe the control information for all 
user written and CICS/VS supplied application programs. 

The following are examples of the DFHPPT macroinstructions used to define the 
processing program table for CICS/VS for System/36 APPC communication: 

DFHPPT TYPE=ENTRY, 

PROGRAM=TESTPROG, 

PGMLANG=COBOL 

TYPE=ENTRY specifies a program entry to the CICS/VS system. 

PROGRAM=TESTPROG specifies a one to eight character program name that 
relates to the program name in the program control table (PCT). 

PGMLANG*COBOL specifies that TESTPROG is written in the COBOL 
language. 

DFHPPT TYPE=GROUP 
FN=(ISC) 

TYPE*GROUP specifies a group entry to the CICS/VS system. 

FN=(ISC) specifies the generic function name that generates the required entries 
for intercommunication support. 
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Systeiii/38 Considerations 


The following paragraphs define the considerations needed for System/36 and 
System/38 to communicate as APPC devices. System/38 defines the 
communications environment with four commands: 

CRTLIND (Create Line Description) 

CRTCUD (Create Control Unit Description) 

CRTDEVD (Create Device Description) 

ADDDEVMODE (Add Device Mode Entry) 

The terminology used by the System/38 differs from System/36. For example, a 
System/36 session group corresponds to a System/38 mode. Refer to the IBM 
System/38 Data Communications Programmer's Guide, SC21-7825, for a complete 
description of the System/38 implementation of APPC. 

System/38 Communications Attributes 

The following paragraphs give only the System/38 attributes that must match a 
corresponding value at the System/36. For a complete description of the 
commands with all the attributes, see the IBM System/38 Data Communications 
Programmers Guide. 

Create Line Description (CRTLIND) Command Attributes 

Line Type (TYPE) for APPC, the line type (protocol) can be either *SDLCP or 
*SDLCS. Only one line in the APPC network can be designated as being the 
primary; all others must be secondary. Specify *SDLCP only if this System/38 is 
to be the primary station in the APPC network. Otherwise, specify *SDLCS. 

The protocol is specified at the System/36 by the Data link protocol prompt on 
display 12.0, SNA Line Member Attributes, during SNA line member 
configuration. 

If there is one System/3 6 and one System/3 8 in the network, one must be the 
primary and the other secondary. If there are more than two systems in the 
network, one must be primary and all others must be secondary. 

Connection Type (CNN) can be point-to-point switched (*SWT), point-to-point 
nonswitched (*PP), or multipoint nonswitched (*MP). 

The line type is specified at the System/3 6 by the Line type prompt on display 
12.0, SNA Line Member Attributes, during SNA line member configuration. 
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NRZI Decoding (NONRTNZ) indicates whether the data communications 
equipment on the line requires the NRZI (non-retum-to-zero[inverted]) 
transmission method. This method must be used if you are using the 
System/38-provided clock. (All data communications equipment on the line must 
use the same transmission method.) 

The value specified here must correspond to the value specified by the SETCOMM 
procedure command at the System/36. 

Station Address (STNADR) For APPC communications, this is the SDLC station 
address by which the System/3 8 is known to the remote system. This parameter is 
valid only if the System/38 line type is *SDLCS (SDLC secondary). 

Since the System/36 is the primary, the value specified here must match the value 
specified for the Remote system’s station address on display 13.0, Remote System 
Attributes, during SNA line member configuration. 

System/38 Exchange Identifier (EXCHID) Specifies the exchange identifier, if any, 
of the local System/38 for APPC communications. The identifier must be 
specified as 022xxxxx, where 022 is the System/38 assigned block number and 
xxxxx is any combination of the hexadecimal characters 0 through 9 and A through 
F. If you do not specify an exchange ID, the System/38 generates one using the 
internal CPU serial number. The DSPLIND command can be used to determine 
the exchange identifier. 

For System/38 APPC communications with System/36, the value specified here 
for the exchange identifier must match the values specified for the Remote system’s 
block ID in hexadecimal and Remote system’s station XID in hexadecimal prompts 
on display 13.0, Remote System Attributes, during System/36 line member 
configuration. Note that the System/38 Block ID is always hexadecimal 022. 

Create Control Unit Description (CRTCUD) Command Attributes 

Control Unit Type (TYPE) For APPC communications with System/36, the type is 
♦PEER. 

Control Unit Address (CTLADR) The control unit’s unique address is expressed as 
four hexadecimal digits in the format yyzz. 

For APPC communications on an SDLC primary line (TYPE(*SDLCP) specified 
in the line description), yy is the SDLC station address of the remote system (the 
Local system’s station address prompt on display 12.0 at the System/36). When 
System/38 is the secondary (TYPE(*SDL(3s) specified in the line description), yy 
can be any hexadecimal value from 01 to FE. zz represents the operational unit 
number; for communications on a nonswitched line, the value entered must be the 
same as the value entered for the operational unit number of the line port 
(LINNBR parameter) on the CRTLIND (Create Line Description) command. For 
switched lines, zz is always 00. 

The control unit address is used only when the control unit is attached to an SDLC 
primary line. On an SDLC secondary line, the value specified for the STNADR 
parameter in the line description is used. 
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Exchai^e Identifier (EXCHID) The eight-digit hexadecimal value used to identify 
the remote control unit on an SDLC line. 

The value is specified as yyyxxxxx, where yyy is the block number of the remote 
system and xxxxx equals the identifier of the remote system. The block number for 
a System/36 is 03E; the identifier is specified by the Local system's station XID in 
hexadecimal prompt on display 12.0 during System/36 SNA line member 
configuration. 

Create Device Description (CRTDEVD) Command Attributes 

Device Type Code (DEVTYPE) For APPC communications, this value is always 
♦PEER. 

Local System Name (LCLLU) specifies the 1 through 8 character name by which 
the local System/38 is known to other devices in the network. Each system 
(logical unit) in the network must have a unique name. 

♦SYS, the default name, specifies that the name assigned to System/38 is to be 
used. That name can be changed using the CHGNETA (Change Network 
Attributes) command. 

Note: The default, *SYS, cannot be used if more than one peer device is attached to 
the control unit. 

The value specified here must match the value specified for the Remote location 
name prompt on display 29.0, Remote Location Selection, during APPC subsystem 
member configuration at the System/36. 

Remote System Name (RMTLU) specifies the name (eight characters maximum) of 
the remote system (the name of the remote system must be unique within the 
network) that this device description defines. The name specified here must be 
different than the LCLLU name specified for the same device description. The 
name specified here is checked against the name received from the remote system 
when the peer link is established. 

The name specified here must match the name specified for the Location name 
prompt on display 22.0 (Subsystem Member Definition) during APPC subsystem 
member configuration at the System/36. 


B-12 Using S/36 Communications 



Add Device Mode Entry (ADDDEVMODE) Command Attributes 

Mode Entry Name (MODE) specifies the name that is to be used by both ends of 
the communications link to refer to this group of sessions. The name specified here 
must match the name specified at the System/36 for the Session group name 
prompt on display 42.0, Session Group Selection, during subsystem member 
configuration at the System/36. 

Maximum Number of Concurrent Sessions (MAXSSN) specifies the maximum 
number (1 through 494) of concurrent sessions that can be active with the remote 
system for this mode. The value specified here should be at least as large as the 
value specified for the maximum number of somce sessions (MAXSRCSSN) 
parameter plus the number of source sessions specified at the remote system. 

When the connection with the remote system is established, the maximum number 
of sessions is negotiated with the remote system, so the number of sessions will be 
less than or equal to this value. 

Note: Each session requested requires system storage resources. You should not 

configure more sessions than you will need so that you can maximize use of 
the system resources. 

The value specified here should match the value specified for the Maximum session 
limit prompt on display 43.0, APPC Session Group Definition, during subsystem 
configuration at the System/36. 

Pre-Bound Sessions (PREBNDSSN) specifies the number of concurrent sessions 
that are to be established when the connection with the remote system is 
established. Once the connection has been established, additional sessions will be 
established on an as-needed basis. 

If a switched line is used, a value of zero specified here allows the System/38 to 
automatically disconnect the line when there are no active sessions (no 
synchronous conversations). A value greater than zero keeps the line active until 
the device is varied offline or a CHGSSNMAX (Change Session Maximum) 
command is entered to change the maximum number of sessions to zero. 

The value specified here must be less than or equal to the value specified for the 
maximum number of source sessions (MAXSRCSSN) parameter. 

Maximum Number of Source Sessions (MAXSRCSSN) specifies the maximum 
number of concurrent source sessions than can be established by this system for 
this mode. The value must be less than or equal to the value specified for the 
maximum number of concurrent sessions (MAXSSN) parameter. 

It is possible for the number of active source sessions shown on the Line Status 
display to exceed the number specified in this parameter if all source sessions are in 
use. If this were true, an available bound target session would then be used by an 
application requiring a session. 

Maximum Number of Concurrent Conversations (MAXCNV) specifies the maximum 
number (1 through 494) of concurrent conversations with the remote system that 
are allowed by this mode entry. 
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A conversation is the temporary connection of a program to a session, and can be 
either synchronous (both the source and target system are communicating) or 
asynchronous (the source has completed and detached from the session, but the 
target is still attached and has access to all the data sent by the source program). 
The value specified for MAXCNV is the sum of the synchronous and asynchronous 
conversations. The value specified here must be at least as large as the value 
specified for the MAXSSN parameter. 

Inbound Pacing (INPACING) specifies the pacing value to be used for incoming 
request/response units (RUs). Valid values are 0 through 63. This parameter 
specifies the maximum number of RUs that are to be received by this mode before 
a response is sent to the remote system. 

This parameter can be used to tune performance. If the value is increased, fewer 
pacing transmissions are required. 

For System/36, 7 is suggested. 

Outbound Pacii^ (OUTPACING) specifies the pacing to be suggested for outgoing 
request/response units (RUs). Valid values are 0 through 63. This parameter 
suggests the maximum number of RUs that are to be sent to the remote system 
before a response is expected from that system. The remote system may choose to 
use a smaller value than specified here. 

This parameter can be used to tune performance. If the value is increased, fewer 
pacing transmissions are required. 

The value specified here should match the value specified at the System/36 for the 
Receive pacing value prompt on display 44.0, APPC Session Group Additional 
Options, during APPC subsystem member configuration. 

Maximum Request/Response Unit Size (MAXLENRU) specifies the maximum size 
of the request/response units that can be received by the local system. Valid 
entries are 256 through 4096 in increments of 256. 

This parameter can be used to tune performance. By using a value of 512 or 
larger, fewer transmissions are needed if the normal data block size is larger than 
256. 

The value specified here should match the value specified at the System/36 for the 
Maximum receive RUsize prompt on display 44.0, APPC Session Group Additional 
Options, during APPC subsystem member configuration. It is recommended that if 
the remote system supports an RU size of 512 or larger, that you specify 
MAXLENRU(512), or larger. 
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Appendix C. Security and APPC 


Security for APPC occurs at two levels: session establishment time (BIND 
security) and transaction establishment time (ATTACH security). 


Session Establishment Security 

When you use APPC in a communications network that has security active, you 
must define a location profile for each remote location with which you will 
communicate. When a session is established, each location’s security manager then 
verifies that the other location is valid and can access secure resources. 

The location profile is defined using the SECEDIT COMM procedure (see the 
Security Guide for a description of the SECEDIT procedure). The profile is created 
within the user ID file for each location (including the local location) within the 
secure network. The location profile consists of the name of the remote location 
(as specified on display 29.0 during APPC subsystem member configuration using 
CNFIGICF), the location password, and an indicator that specifies whether a user 
password is required to start procedures at the remote location. 

Location name specifies the name assigned to the remote location. This name must 
be the same as the corresponding Remote location name specified on display 29.0 
during subsystem member configuration. 

Location password specifies the password that is to be exchanged when 

communicating with this location. The value specified here must be the same as 
the value specified at the remote system for your (the local) location. 

The password can be from 2 through 16 hexadecimal characters, or *NULL. A 
password of *NULL allows non-secure or secure locations to establish sessions 
with a secure location. 

Require password for starting procedure specifies whether the remote location can 
verify the user when a procedure is requested or whether the local security 
manager will verify the user. 

If No is specified, the local security manager does not verify the user and if the 
remote security manager indicates that the user is already verified and does not 
require a password to start procedures that are initiated from the remote 
location. The local system assumes that the remote location system manager has 
verified the security level of the requesting user. 
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If Yes is specified, a password is required from the remote location before a 
procedure can be started on the local system. 

Note: If you answer Yes, your password will be classified as already been verified 
(AVI). AVI is used later in this section. 


Security at Transaction Establishment 

When an EVOKE is issued, security information can be sent with the EVOKE 
request. When the local system issues an EVOKE, the following parameters can be 
supplied: 

• User ID 

• Password 

• Profile ID (can only be specified if the local application is using externally 
defined data formats as generated by IDDU) 

For a complete description of the EVOKE process, see the manual ICF Reference. 

The parameters passed on the EVOKE process are handled as follows: 

• If the remote location does not have a security manager, no security 
information is passed with the EVOKE 

• If the remote location has a security manager, two types of security can be sent 
with the EVOKE: 

- Security supplied by the application program 

— Security information supplied by the APPC subsystem. 

If the user ID is not 8 blanks, the user ID, password, and profile ID are 
passed with the attach request. 

If the user ID is 8 blanks, the sign-on user ID (with no password or profile 
ID) is sent with the attach request with an indication that the user ID has 
already been verified. No security information is sent by the local APPC 
subsystem if password security is not active or if the remote location does 
not accept an already verified indicator. 
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REMOTE SYSTEM > 

LOCAL SYSTEM 

V 

LOCATION PASSWORD 
SPECIFIED FOR 

REMOTE LOCATION (1) 

NO LOCATION PASSWORD 
SPECIFIED FOR 

REMOTE LOCATION (2) 

♦NULL PASSWORD 
SPECIFIED FOR 

REMOTE LOCATION (1) 

Location password is 
specified for the 
remote location (1) 

BIND is secure if the 
passwords match (3) 

BIND is rejected - 
Configurations do not 
match 

BIND is rejected - 
Configurations do not 
match 

No location password 
is specified for the 
remote location (2) 

BIND is rejected - 
Configurations do not 
match 

BIND is accepted, but 
is not secure 

BIND is accepted, but 
is not secure 

*NULL is specified for 
the remote location (1) 

BIND is rejected - 
Configurations do not 
match 

BIND is accepted, but 
is not secure 

BIND is secure (3) 


Figure C-1. APPC Security 


Notes: 

1. Security must be active for location passwords to be used. 

2. Password security need not be active, 

3. The user ID or password can be sent on an attach request only when the BIND is 
secure. 

4. Only a master security officer can use the SECEDIT COMM procedure. 

5. An application program interface (API) supplied user ID and/or password on an 
evoke operation will be ignored if the BIND is unsecure. 

6. If the BIND is secure, in order to specify only the sign-on user ID-A VI(already 
verified interface)=YES(SECURITYssSAME), the user ID specified on the 
evoke operation must be 8 blanks. 

7. If the BIND is unsecure or the remote location does not allow the A VI and 
SECURITYs=SAME is specified (user ID^8 blanks) on an evoke operation, no 
user ID or password is sent with the attach request. 

8. If no password or user ID is specified with an attach request received by a S/36, 
the user ID and PASSWORD used to start the procedure on the S/36 default to 
*NULL and 4 blanks, respectively. 
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Appendix D. Syntax Diagrams 


This appendix contains the System/36 syntax diagrams for all of the procedures 
used in this book. These diagrams are in alphabetical order. 


I ALTERCOM Procedure 


ALTERCOM line number , SWITCHED,Taa] , remote id , local id , , 
2 ^MA> R R 

J [mcJ J [ J 

NONSWTCH,,,, 

MULTTRIB,,,, tributary address 
R 

MULTCONT,,,, 

SHM,,,, 


NONE , bsc wait time , MULTFILE , record separator , FULL 
COMPRESS R NONMULT R HALF 
TRUNCATE 


SNBU , bsc retry count , sdlc time out , sdlc retry count 
NOSNBU R 



Refer to Chapter 2 for an explanation of this procedure and a description of the 
parameters. 
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DEFINEID Procedure 


DEFINEID 

'display' 

UPDATE 



DELETE 

’ 


S9020099-0 


Refer to Chapter 5 for an explanation of this procedure and a description of the 
parameters. 


DEFINEPN Procedure 


DEFINEPN 


S9020100-0 


This procedure has no parameters. Refer to Chapter 5 for an explanation of this 
procedure. 
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DEFINLOC 


DEFINLOC 


S9020S16-0 

This procedure has no parameters. Refer to Chapter 11 for an explanation of this 
procedure. 


DEFINX21 



r 1 


DEFINX21 

NONSHM 



SHM 



L 



S9020101-1 

Refer to Chapter 5 for an explanation of this procedure and a description of the 


parameters. 


DEFINX25 Procedure 


DEFINX25 


89020102-0 

There are no parameters for this display. Refer to Chapter 5 for an explanation of 
the procedure. 


DISABLE Procedure 


DISABLE subsystem configuration name. 


location name 


S9020109-0 


Refer to Chapter 6 for an explanation of this procedure and a description of the 
parameters. 
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ENABLE Procedure 


ENABLE 

subsystem configuration name, 

library 

current 

name 

library 

f 

line number 




. 

1 





NOSHOW 

f 

location name 

SHOW 


L 

. 




S9020113-0 


Refer to Chapter 6 for an explanation of this procedure and a description of the 
parameters. 


ICFDEBUG Procedure 


ICFDEBUG 

fON 1 



OFF 

CRT 

CRT,job name 

► 


PRINT 



PRINT,job name 



S9020134-0 


Refer to Chapter 7 for an explanation of this procedure and a description of the 
parameters. 
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PASSTHRU Procedure 


PASSTHRU remote location name 


session group name 


S9020510-0 


Refer to Appendix G for an explanation of this procedure and a description of the 
parameters. 


REQUESTX Procedure 


REQUESTX 

source member name 


library name 

f 

NOENTRY 




current library 


ENTRY 


S9020197-1 

Refer to Chapter 8 for an explanation of this procedure and a description of the 
parameters. 
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SETCOMM Procedure 


SETCOMM 

line number 

r 

NONSWTCH 

f 

CLOCK 

t 

NRZI 

9 

CONCAR 

/ 

TONE 


I 


SWITCHED 

MULTTRIB 

MULTCONT 

SHM 


NOCLOCK 


NONRZI 


NOCONCAR 


NOTONE 




' 





SEP 

NOSEP 

9 

EON 

NOEON 

r 

sdlc time-out value 

f 

sdlc retry count 



. 






" 


• 


“ 

IBM386X 

f 

X25 

/ 

2400BPS 

IBM387X 


NOX25 


4800BPS 

NONIBM 




9600BPS 

IBMLPDA 



56KBPS 

. ^ 


. 


89020242-1 


Refer to Chapter 2 for an explanation of this procedure and a description of the 
parameters. 


STARTM Procedure 



89020257-0 


Refer to Chapter 7 for an explanation of this procedure and a description of the 
parameters. 
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STATES! Procedure 


STATEST 


S90202S8-0 


There are no parameters for this procedure. Refer to Chapter 7 for an explanation 
of this procedure. 


STOPGRP Procedure 


STOPGRP location. 

group 

f 

N 


• 


Y 


89020260-0 


Refer to Chapter 10 for an explanation of this procedure and a description of the 
parameters. 


STOPM Procedure 


STOPM line number 


S9020259-0 

Refer to Chapter 7 for an explanation of this procedure and a description of the 
parameters. 
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STRTGRP Procedure 


STRTGRP location 


group 


S9020261-0 


Refer to Chapter 10 for an explanation of this procedure and a description of the 
parameters. 
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Appendix E. Connection Values for Configuration (Switched Lines) 


BSCEL and CICS Subsystems 

Appendix E provides a chart of possible valid combinations for switched line 
member configurations. 


If you want to: 

Enter on Display 10.0: 

With Autocall Feature 

With X.21 Feature 

Prompt 4 

Switch Type at 
ENABLE 

Prompt 5 

Switch Type for 

Session Initiation 

Prompt 4 

Switch Type at 
ENABLE 

[- 

Prompt 5 

Switch Type for 
Session Initiation 

Cali Manually or Call 

Automatically (if a phone list 
exists) 

When the: 

Subsystem is enabled 

^Session is acquired 

Not valid 

(You must first acquire a session.) 

Not valid 

(You must first acquire a session.) 

1 - Inactive^ 
or 

•2-Answer^ 

1-Manual call* 

1-Inactive 
or 

•2-Answer 

2-Autoanswer 
(you must specify 
a phone list) 

Answer Manually 

When the: 

Subsystem is enabled 

Subsystem is acquired 

Session is remotely started 

Not valid 

(You must first acquire a session.) 

Not valid 

(You cannot answer manually 
with the X.21 feature.) 

1-Inactive 
or 

•2-Answer 


1-Inactive^ 
or 

•2-Answer 

3-Manual answer^ 

Answer Automatically 

When the: 

•Subsystem is enabled 

Session is acquired 

Session is remotely started 

2-Answer 

•1-Manual calP 
(Message appears 
when you initiate a 
session.) 
or 

2- Autoanswer^ 

(No message appears 
when you initiate a 
session.) 
or 

3- Manual answer^ 
(Message appears 
when you initiate a 
session.) 

2-Answer 

2-Autoanswer 
(No message 
appears when you 
initiate a session.) 

1-Inactive 
or 

•2-Answer 

2-Autoanswer 

1-Inactive 
or 

•2-Answer 

2-Autoanswer 

1 - Inactive'* 
or 

•2-Answer 

2-Autoanswer 

1-Inactive^ 
or 

*2-Answer 

2-Autoanswer 

•Recommended choices. 

^The Autocall feature allows you to call manually or automatically. Your call is made automatically, it you specify a phone list. If no phone list exists, a message appears 
and you must call manually. 

message will appear, and you must answer the call manually. 

^The value you specify for prompt 4, when you enable the subsystem, is overridden when you acquire a session. However, you must enter a value. 

^System/36 will not answer calls when you enable the subsystem. You must first acquire a session. 
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CCP Subsystem 



Enter on Display 10.0: 

If you want to: 

With Autocall Feature 

With X.21 Feature 

Prompt 4 

Switch Type at 
ENABLE 

Prompt 5 

Switch Type for 

Session Initiation 

Prompt 4 

Switch Type at 
ENABLE 

Prompt 5 

Switch Type for 

Session Initiation 

Call Manually or Call 

Automatically (if a phone list 
exists) 

When the: 

Subsystem is enabled 

Session is acquired 

Not valid 

(You must first acquire a session.) 

Not valid 

(You must first acquire a session.) 

1-Inactive 

or 

*2-Answer 

P— 

1-Manual calP 

1-Inactive 

or 

•2-Answer 

2-Autoanswer 

Answer Manually 

When the: 

Subsystem is enabled 

Session is acquired 

Session is remotely started 

Not valid 

(You must first acquire a session.) 

Not valid 

1-Inactive 

or 

•2-Answer 

3-Manual answer 

1-Inactive^ 
or 

•2-Answer 

3-Manual answer 

Answer Automatically 

When the: 

Subsystem is enabled 

Session is acquired 

Session is remotely started 

2-Answer 

•1-Manual calP 
or 

2- Autoanswer’ 

or 

3- Manual answer’ 

1-Inactive 

or 

*2-Answser 

2-Autoanswer 

1-Inactive 

or 

•2-Answer 

2-Autoanswer 

1-Inactive^ 
or 

•2-Answer 

2-Autoanswer 

1-Inactive^ 
or 

•2-Answer 

_ 1 

*1-Manual call 
(A message may 
appear when you 
initiate a session.) 

or 

2- Autoanswer 

or 

3- Manual answer 
(A message may 
appear when you 
initiate a session.) 

1-Inactive^ 
or 

•2-Answer 

2-Autoanswer 

“Recommended choices. 

^The Autocall feature allows you to call manually or automatically. Your call is placed automatically, if you specify a phone list. If no phone list exists, a message will appear 
and you must call manually. 

^System/36 will not answer calls when the subsystem is enabled. You must first acquire a session. 
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Finance Subsystem 



Enter on Display 

12.0: 

Enter on Display 

13.0: 

Enter on Display 

12.0: 

Enttr on Display 

13.0: 

Enter on Display 

1 12.0: 

Enter on Display 
13.0: 


With Autocall feature 

With X.21 Feature 

With X.25 Feature 

If you want to: 

Prompt 3 

Switch Type at 

ENABLE 

Prompt 5 

Switch Type for 

Session Initiation 

Prompt 3 

Switch Type at 

ENABLE 

Prompt 6 

Switch Type for 

Session Initiation 

Prompt 3 

Prompt 5 

Call Manually or Call 
Automatically (if a phone 
list exists) 







When the: 







Subsystem is enabled 

1-Inactive 

or 

4-Manual call 

1-Call 

(prompt does 
not appear) 

Not valid 

1- Inactive or 

2- Autoanswer 

1-Call 

Session is acquired 

Not valid 

(You must call when the subsystem is enabled.) 



Not valid 

Answer Manually 







When the; 







Subsystem is enabled 

1-Inactive 

pr 

3-Manual answer 

3-Manual answer 

(prompt does 
not appear) 

Not valid 

Not valid 

Session is acquired 

Not valid 

(You must answer when the 
subsystem is enabled.) 





Session is remotely 
started 

Not valid 

(You must answer when the 
subsystem is enabled.) 





Answer Automatically 







When the: 







Subsystem is enabled 

1 -Inactive 

or 

2-Autoanswer 

2-Autoanswer 

2-Autoanswer 

•1-Call’ 

or 

2- Autoanswer’ 

or 

3- Manual answer’ 

1- Inactive 

or 

2- Autoanswer 

2-Autoanswer 

Session is acquired 

Not valid 

(You must answer when the 
subsystem is enabled.) 

Not valid 

(You must answer when the 
subsystem is enabled.) 

Not valid 

(You must answer when the 
subsystem is enabled.) 

Session is remotely 
started 

Not valid 

(You must answer when the 
subsystem is enabled.) 

Not valid 

(You must answer when the 
subsystem is enabled.) 

Not valid 

(You must answer when the 
subsystem is enabled.) 


•Recommended choices. 


^The value you specify for prompt 7, when you acquire a session, is ignored. However, you must enter a value. 
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APPC Subsystems: Primary and Secondary SDLC Support 



Enter on 
Display 12.0: 

Enter on 

Display 13.0: 

Enter on 
Display 12.0: 

Enter on 

Display 13.0: 

Enter on 
Display 12.0: 

Enter on 

Display 13.0: 

With Autocall Feature 

With X.21 Feature 

With X.25 Feature 

Prompt 3 

Switch Type at 
ENABLE 

Prompt 5 

Switch Type for 
Session 

Initiation 

Prompt 3 

Switch Type at 
ENABLE 

Prompt 5 

Switch Type for 
Session 

Initiation 

Prompt 3 

Switch Type at 
ENABLE 

Prompt 5 

Switch Type 
for Session 

Initiation 

4-Manual call 

(cannot use a 
phone list)’ 

Ignored^ 

Not valid 

Not valid 

2-Autoanswer 

1-Call 

2-Autoanswer 

l-Call 

1- Inactive or 

2- Autoanswer 

1-Call 

Not valid 

Not valid 

Not valid 

3-Manual 

answer 

Not valid 

Not valid 

Not valid 

1-Inactive 

3-Manual 

answer 





Not valid 





2-Autoanswer 

Ignored^ 

2-Autoanswer 

Ignored^ 

Not valid 

1 Not valid 

Not valid 



2-Autoanswer 

Ignored^ 

2-Autoanswer 

Ignored^ 

2-Autoanswer 

1- Call or 

2- Autoanswer 


Call Manually or Call 
Automatically (if a phone 
list exists) 

When the: 

Subsystem is enabled 


^Session is acquired’ 

Session is remotely 
started 


Answer Manually 

When the: 

Subsystem is enabled 

Session is acquired 

Session is remotely 
started 


Answer Automatically 

When the: 

Subsystem is enabled 

Session is acquired 

•Session is remotely 
started 


•Recommended choices. 


’ If a phone list exists and you specify a phone list name, your system will call automatically. For X.25, you must specify a phone list i 
^In some cases this prompt is not shown. 
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Peer Subsystems: Primary and Secondary SDLC Support 



Enter on 

Display 12.0: 

Enter on 

Display 13.0: 

Enter on 
Display 12.0: 

Enter on 

Display 13.0: 

Enter on 

Display 12.0: 

Enter on 

Display 13.0: 

If you want to: 

Cali Manually or Call 
Automatically (if a phone 
list exists) 

When the: 

Subsystem is enabled 

“Session is acquired^ 

Session is remotely 
started 

With Autocall Feature 

With X.21 Feature 

With X.25 Feature 

Prompt 3 

Switch Type at 

ENABLE 

Prompt 5 

Switch Type for 

Session 

Initiation 

Prompt 3 

Switch Type at 

ENABLE 

Prompt 5 

Switch Type for 
Session 

Initiation 

Prompt 3 

Switch Type at 

ENABLE 

Prompt 5 

Switch Type 
for Session 

Initiation 

4-Manual call 

(cannot use a 
phone list)’ 

Ignored^ 

Not valid 

Not valid 

2-Autoanswer 

Ignored^ 

2-Autoanswer 

l-Call 

1- Inactive of 

2- Autoanswer 

1-Call 

Not valid 

Not valid 

Not valid 

Answer Manually 

When the: 

Subsystem is enabled 

Session is acquired 

Session is remotely 
started 

3-Manual 

answer 

Not valid 

Not valid 

Not valid 

Not valid 

3-Manual answer 

Answer Automatically 

When the: 

Subsystem is enabled 

Session is acquired 

“Session is remotely 
started 

2-Autoanswer 

Ignored^ 

2-Autoanswer 

Ignored^ 

Not valid 

Not valid 

Not valid 

2-Autoanswer 

Ignored^ 

2-Autoanswer 

Ignored^ 

2-Autoanswer 

1- Call or 

2- Autoanswer 


^Recommended choices. 


’ If a phone list exists and you specify a phone list name, your system will call automatically. For X.25, you must specify a phone list name. 
^In some cases this prompt is not shown. 
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SNUF, SNA MSRJE, and SNA 3270 Subsystems 


If you want to: 

Enter on Display 

12.0: 

Enter on Display 

13.0: 

Enter on Display 

12.0: 

Enter on Display 

13.0: 

Enter on Display 

12.0: 

Enter on Display 
13.0: 

With Autocall Feature 

With X.21 Feature 

With X.25 Feature‘s 

Prompt 3 

Switch Type at 

ENABLE 

Prompt S 

Switch Type for 

Session Initiation 

Prompt 3 

Switch Type at 

ENABLE 

prompt 5 

Switch Type for 

Session Initiation 

Prompt 3 

Switch Type at 

ENABLE 

Prompt S 

Switch Type for 
Session Initiation 

Call Manually or Call 
Automatically (if a phone 
list exists) 

When the: 

Subsystem is enabled 

4-Manual call (cannot 
use a phone iist)^ 

(prompt does 
not appear) 

4-Manual call (cannot 
use a phone list)^ 

(prompt does 
not appear) 

Not Valid 

Session is acquired 

1-Inactive 

or 

•2-Autoanswer 

1-Call^ 

1-Inactive 

or 

•2-Autoanswer 

1-Call^ 

1- Inactive 

or 

2- Autoanswer 

1-Call’ 

Answer Manually 

When the: 

•Subsystem is 
enabled 

3-Manual answer 

(prompt does 
not appear) 



Session is acquired 

1-Inactive^ 
or 

*2-Autoanswer 

3-Manual answer 

Not valid 

Not valid 

Session is remotely 
started 

(not valid for SNA 

MSRJE 

or SNA 3270) 

1-Inactive 

or 

•2-Autoanswer 

3-Manual answer 



Answer Automatically 

When the: 

•Subsystem is 
enabled 

2-Autoanswer^ 

•1-Call 

or 

2- Autoanswer 

or 

3- Manual answer 

2-Autoanswer 

•1-Call 

or 

2- Autoanswer 

or 

3- Manual answer 

2-Autoanswer 

•1-Call’ 

or 

2'-Autoanswer 

Session is acquired 

1 - Inactive^ 
or 

•2-Autoanswer 

2-Autoanswer 

1-Inactive 

or 

•2-Autoanswer 

2-Autoanswer 

1 - Inactive 

or 

2-Autoanswer 

2-Autoanswer 

Session is remotely 
started 

(not valid for SNA 

MSRJE 

or SNA 3270) 

1-Inactive 

or 

•2-Autoanswer 

2-Autoanswer 

1-Inactive 

or 

•2-Autoanswer 

2-Autoanswer 

1- Inactive 

or 

2- Autoanswer 

2-Autoanswer 


•Recommended choices. 


' If a phone list exists and you specify a phone list name, your system will call automatically. For X.2B, you must specify a phone list name. 

^If you do not specify 0 for the number of program start logical units on display 31.0, you will get a message when you enable the subsystem. The message will indicate how 
to connect the line. 

^The value you specify for prompt 3, when you enable the subsystem, is overridden when you start a session. However, you must enter a value. 

System/36 always attaches to an X.25 network using a nonswitched line. The values specified here define how the virtual circuits will be used. 
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BSC MSRJE Subsystem 


The values in this chart apply after you enable the BSC MSRJE subsystem and 
enter the MSRJE command. 



Enter on Display 10.0: 

If you want to: 

With Autocall Feature 

With X.21 Feature 

Prompt 5 

Switch Type for Session Initiation 

Prompt 5 

Switch Type for Session Initiation 

Call Manually or 

Cali Automatically 

(if a phone list 
exists)’ 

1-Manual call 

2-Autoanswer^ 

Answer Manually 

3-Manual answer 

Not valid 

Answer 

Automatically 

2-Autoanswer 

2-Autoanswer 

’Vour system will call automatically if a phone list exists, no matter what you specify for prompt 5. 

^You must specify a phone list. 
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Appendix F. APPC Implementation of the LU6.2 Architecture 


This appendix contains a description of System/36 APPC implementation of the 
SNA Logical Unit Type 6.2 (LU6.2) architecture. It presents LU6.2 verbs, 
programming-like statements that define the interactions between programs and 
LUs for conversation resources. The verbs and their parameters are described in 
detail in the SNA Transaction Programmer’s Reference Manual for LU6.2. 

This appendix briefly describes each verb for basic conversations. It then gives the 
SSP-ICF operations that perform the equivalent functions for System/36. 


Basic Conversations 

This section describes the LU6.2 verbs for basic conversations. 

Specifying the Session ID 

The RESOURCE parameter for LU6.2 verbs is specified in S/36 by the session 
ID. The session ID is specified in the SYMID parameter of the session OCL 
statement and in the TERMID parameter of the $WSIO macro or the $DTFW 
macro in Assembler. 


ALLOCATE 


The LU6.2 verb ALLOCATE builds a conversation to a named partner program at 
another logical unit (LU). For the APPC subsystem, it is specified by the 
combination of the acquire and evoke operations. 
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The acquire operation, with its associated SESSION OCL statement, corresponds 
to the following ALLOCATE parameters: 


ALLOCATE 

Acquire or SESSION 

LU_NAME 

Specified by the location parameter of the 

SESSION statement 

MODE__NAME 

Specified by the group parameter of the SESSION 
statement 

RESOURCE 

The session ID (see “Specifying the Session ID” 
on page F-1) 

RETURN_CODE 

Specified by the SSP-ICF return code 


The evoke operation corresponds to the following ALLOCATE parameters: 


ALLOCATE 

Evoke 

TPN (transaction program name) 

Remote process name parameter 

SECURITY(SAME) 

User ID parameter must be eight blanks 

SECURITY(PGM(variable)) 

User ID, password, and profile parameters (the 
profile parameter is valid for IDDU only) 

SYNC_LEVEL 

Synchronization level parameter 

TYPE 

Conversation type parameter 

PIP(NO) (process information 
parameters) 

No process information parameters specified on 
the evoke operation 

PIP(YES) 

Process information parameters specified on the 
evoke operation 

RESOURCE 

The session ID (see “Specifying the Session ID” 
on page F-1) 

RETURN__CODE 

Specified by the SSP-ICF return code 
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CONFIRM 


CONFIRM ends a message and asks the remote transaction program to confirm 
that no errors have been detected in the message. 

For APPC, CONFIRM can be specified as a modifier (confirm) to the following 
operations: 

• Put 

• Get, in send state 

• Evoke 

Confirm can be specified in assembler using the OPM-CONFIRM modifier to the 
operations, or by the confirm indicator in an IDDU format. 

The table that follows shows how CONFIRM parameters are specified in 
operations. 


CONFIRM 

APPC 

RESOURCE 

The session ID (see “Specifying the Session ID” on 
page F-1) 

RETURN_CODE 

Specified in the SSP-ICF return code 

REQUEST_TO__SEND_RECEIVED 

Specified in the SSP-ICF return code 


CONFIRMED 


CONFIRMED sends a confirmation reply to the remote program. By sending 
CONFIRMED, the local application program takes responsibility for any data it 
has received. This verb is valid only in response to a CONFIRM request. 

For System/36, a program responds to a CONFIRM request by issuing any valid 
operation other than fail or end of session (abnormal). The RESOURCE parameter 
of the CONFIRMED verb is specified by the session ID (see “Specifying the 
Session ID’’on page F-1). 
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DEALLOCATE 


The DEALLOCATE verb ends a conversation. 

System/36 APPC uses the put end of transaction, release, and end of session 

operations (in various combinations) to perform the functions of the 

DEALLOCATE verb. 

Deallocation requires two steps: 

1. The local program must issue an evoke end of transaction or put end of 
transaction operation, or it must receive a return code indicating end of 
transaction. 

2. The local program must issue an end of session or a release operation to 
complete the deallocation. The release operation can be used only if the local 
program acquired the session. 


DEALLOCATE 

Put or Evoke 

End of Transaction 

Release or 

End of Session 

RESOURCE 

The session ID (see “Specifying 
the Session ID” on page F-1) 

The session ID (see “Specifying 
the Session ID” on page F-1) 

TYPE (SYNC_LEVEL), when 
the synchronization level for this 
conversation is NONE; or TYPE 
(FLUSH) 

For assembler, specified by the 
OPM-ZERO parameter 


TYPE (SYNC__LEVEL), when 
the synchronization level for this 
conversation is CONFIRM 

For assembler, specified by the 
OPM-CONFIRM parameter; or 
a synchronization level of 
’ CONFIRM may be specified 
using IDDU 


TYPE (ABEND_PROG) 


For abnormal termination, an 
end of session operation during 
an active transaction 

TYPE (LOCAL) 


End of session or release 
operation after APPC receives a 
return code indicating end of 
transaction 

RETURN_CODE ’ 

SSP-ICF 
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FLUSH 


The FLUSH verb causes all buffered data and control information to be sent. 

System/36 APPC uses the put operation with a data length of zero and no 
modifiers to perform this operation. The RESOURCE parameter of the FLUSH 
verb is specified in the TERMID parameter of the $WSIO macro for assembler. 

GET_ATTRIBUTES and GET_TYPE 

The GET_ATTRIBUTES verb requests information about the conversation by 

which the program was started. GET_^TYPE requests only the conversation type. 

For APPC, these functions are performed by the get status operation. The 
RESOURCE parameter of the LU6.2 verbs is specified by the session ID (see 
“Specifying the Session ID” on page F-1). 

The values are returned in the record buffer associated with this DTF (define the 
file). The length of the record buffer must be at least 128 bytes. The following 
values are returned in the record buffer, starting at byte 11: 


Field 

Lei^h 

(bytes) 

Description 

Subsystem 

1 

Subsystem type (APPC) 

Synchronization level 

1 

NONE (0), or CONFIRM (1) 

Conversation type 

1 

Mapped (M) or basic (B) 

Reserved 

3 


Own fully qualified LU 
name 

17 

Local location name qualified by network ID 

Partner LU name 

8 

Remote location name 

Partner fully qualified LU 
name 

17 

Remote location name, qualified by network 

ID 

Mode Name 

8 

Session group name 

User ID 

8 

User ID 

Reserved 

54 
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POST ON RECEIPT 


The POST_ON_^RECEIPT verb causes the LU to post the specified 

conversation when information is available for the program to receive. The 
information can be data, conversation status, or a request for confirmation or sync 
point. 

APPC uses the invite operation to perform this function. 


POST_ON_RECEIPT 

Invite 

RESOURCE 

The session ID (see “Specifying the Session ID” on 
page F-1) 

LENGTH 

Specified in the DTE 
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PREPARE TO RECEIVE 


The PREPARE_TO_RECElVE verb changes the conversation from send state 

to receive state so that the local program can receive data. 

APPC performs this function using the put then invite and put then get operations 
with data length of zero. 

The put then invite operation performs the LU6.2 functions of 
PREPARE__TO___RECEIVE and then POST__ON_RECEIPT. The following 
table relates the LU6.2 verb to the put then invite operation: 


PREPARE__TO_RECEIVE 

Put Then Invite 

RESOURCE 

The session ID (see “Specifying the Session ID” on 
page F-1) 

TYPE (SYNC_LEVEL), 
when the synchronization 
level for this conversation is 
CONFIRM 

For assembler, specified by the OPM-CONFIRM 
modifier; on the WSIO, on the CONFIRM indicator 
when using IDDU 

TYPE (SYNC_LEVEL), 
when the synchronization 
level for this conversation is 
NONE; or TYPE (FLUSH) 

For assembler, OPM-ZERO 

LOCKS (SHORT) 

Implied by the use of the put then invite operation 
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The put then get operation performs the LU6.2 functions of 
PREPARE_TO__RECEIVE and then RECEIVE__AND__WAIT. The 
following table relates the LU6.2 verb to the put then get operation: 


PREPARE_TO_RECEIVE 

Put Then Get 

RESOURCE 

The session ID (see “Specifying the Session ID” on 
page F-1) 

TYPE (SYNC__LEVEL), 
when the synchronization 
level for this conversation is 
CONFIRM 

For assembler, OPM-CONFIRM; CONFIRM may 
be specified using IDDU 

TYPE (SYNC__LEVEL), 
when the synchronization 
level for this conversation is 
NONE; or TYPE (FLUSH) 

For assembler, OPM-ZERO 

LOCKS (LONG) 

Implied by the use of the put then get operation 
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RECEIVE AND WAIT 


The RECEIVE__AND_^WAIT verb waits for information to arrive on the 

specified conversation and then receives the information. If information is already 
available, the program receives it without waiting. The information can be data, 
conversation status, or a request for confirmation. Control is returned to the 
program with an indication of the type of information. 

APPC uses the get operation to perform this function. The following table relates 
the LU6.2 parameters to the operation: 


RECEIVE__AND__WAIT 

Get 

RESOURCE 

The session ID (see “Specifying the Session ID” on page F-1) 

FILL (BUFFER) 

Implied in the get operation 

LENGTH 

Specified in the INLEN parameter of the $WSIO macro for 
assembler 

DATA 

Data buffer in the DTF 

WHAT_RECEIVED 

SSP-ICF Return code 

REQUEST__TO_SEND_RECEIVED 

SSP-ICF Return code 

RETURN_CODE 

SSP-ICF Return code 


REQUEST__TO_SEND 

The REQUEST_^TO_SEND verb tells the remote program that the local 

program requests to enter send state for the conversation. The conversation is 
changed to send state when the local program receives a SEND indication from the 
remote program. 

APPC uses the request to change direction then invite and request to change 
direction then get operations to perform this function. The LU6.2 RESOURCE 
parameter is specified by the session ID (see “Specifying the Session ID” on 
page F-1). 
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SEND__DATA 

The SEND_DATA verb sends data to the remote transaction program. APPC 

uses the put operation to perform this function. The following table relates the 
LU6.2 parameters to the operation: 


SEND__DATA 

Put 

RESOURCE 

The session ID (see “Specifying the Session ID” on page F-1) 

DATA 

Data buffer in the DTE 

LENGTH 

Specified in the OUTLEN parameter of the $WSIO macro for 
assembler 

RETURN__CODE 

SSP-ICF Return code 

REQUEST_TO_SEND_RECEIVED 

Return code 


SEND_ERROR 

The SEND_TERROR verb informs the remote transaction program that the local 

program detected an error. APPC uses the fail operation for this function. The 
following table relates the LU6.2 parameters to the operation: 


SEND_ERROR 

FaU 

RESOURCE 

The session ID (see “Specifying the Session ID” on page F-1) 

TYPE(PROG) 

Implied in the FAIL operation 

RETURN_CODE 

Return code 

REQUEST_TO_SEND_RECEIVED 

Return code 
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WAIT 


The WAIT verb waits for data or information from one or more active 
conversations. APPC uses the accept operation to wait for input from one or more 
previously invited sessions. The following table relates the LU6.2 parameters to 
the operation; 


WAIT 

Accept 

RESOURCE_LIST 

Implied by the previous invite 

RETURN_CODE 

SSP-ICF Return code 

RESOURCE-POSTED 

Specified in the TERMID parameter of the $WSIO macro, for 
assembler 
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Appendix G. Display Station Pass-Through 


When using Display Station Pass-Through, you can, while working at a display 
station attached to one System/36, sign on to another System/36 and run 
appUcations on the remote system. While you are using a pass-through session, 
your display appears as if it were attached to the remote system. 

Before you can use Display Station Pass-Through, you must configure and activate 
an APPC subsystem on both the local and remote systems. Refer to Chapter 9, 
“Configuring for Advanced Program-to-Program Communications” for more 
information on APPC. 

Refer to Appendix C, “Security and APPC” for information about security for 
display station pass-through. 


PASSTHRU Procedure 

Following is a copy of the PASSTHRU Procedure prompt display and an 
explanation of the parameters: 


PASSTHRU PROCEDURE 

Sign on and run interactive applications 
on a remote system. 


Remote location name 
Session group name . 



* 


Cmd3-Previous menu 



COPR IBM Corp. 1986^ 
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1 Remote location name specifies the remote location that you wish to sign on to. 

I This is a required parameter. 

I Session group name specifies the APPC session group to be used by Display Station 

I Pass-Through. If no parameter is specified, the session group name (configured 

I as the default) is used. If a session group name of blanks is desired, *BLANK 

I must be specified. 

I After this procedure has been entered, a pass-through session is started for the 

I evoking display, and the sign-on display from the remote system appears. At this 

I time, you can sign on to the remote system. 

I Note: If password security is active on the remote system, you must have a valid user 

I ID and password for the remote system in order to sign on. 


I The Display Station Pass-Throi^h Session 

I The Display Station Pass-Through session looks very much like you are working at 

I a display station attached to the remote system. The command display that you see 

I is from the remote system, entered procedures will be run on the remote system, 

I the status displays are from the remote system, and printed output will be routed to 

I a printer on the remote system. Operational differences that you will see when you 

1 are signed on to a Display Station Pass-Through session are described in the next 

I section. 

I A display station ID unique to the remote system is generated when the 

I pass-through session is started. You will see this ID in the upper right corner of 

I your display, and any jobs you create during the pass-through session will have job 

I IDs which start with this display station ID. 
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Operational Differences During a Pass-Through Session 

Operational differences while using a pass-through session are: 

• If you are working at a console or a subconsole and you press the Sys Req and 
Enter keys during the session, the display will function as the console or 
subconsole for the local system only. When the Sys Req and Enter keys are 
pressed again, you will continue with your pass-through session. 

• When you go from the command display to the console or subconsole display, 
your data will be saved. When you return to the command display, your data is 
restored. 


• When you press the Attn key, the Display Station Pass-Through Inquiry 

Options display is shown. On this display, you can request the inquiry options 
display for the local or the remote system. Following is the Display Station 
Pass-Through Inquiry Options display and an explanation of the options; 
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0-Resiune normal Display Station Pass-Throi^h processii^ resumes normal 
Display Station Pass-Through processing 

1- Process system inquiry for the local system interrupts the Display Station 
Pass-Through session and causes the inquiry options display from the local 
system to be displayed. 

2- Process system inquiry for the remote system interrupts the application 
running at the remote system and causes the inquiry options display from 
the remote system to be displayed. 

Note: If you choose option 2, the display from which you originally pressed 
the Attn key will temporarily reappear. After a short delay, the 
inquiry options display for the remote system appears. 

• Extended (EXTN) aids will only be processed at the local system. When you 
enter an EXTN aid, the characters displayed will be obtained from the EXTN 
file on the local system. The EXTN file on the local system will also be used 
for displays. However, for output to printers located on the remote system 
(Print key output), the extended characters will be obtained from the remote 
system’s EXTN file. It is possible that you could get different character images 
for the same code points for the printed output as compared to the images 
displayed on the screen when the Print key was pressed. You will need to keep 
the extended characters on both the remote and local systems in sync. 

• If the message light comes on and you enter the MSG command, no messages 
may be displayed if the message originated from the local system. To display 
messages from the local system, you will have to process system inquiry for the 
local system. 

• The display station owner type shown in the work station error messages will 
always be SRT. The available options will always be 2 and 3. Therefore, 
when the command display is shown from the remote system and the display 
station is powered off, message SYS-7300 will appear with options 2 and 3 
rather than with options 1 and 3. Option 2 will give a permanent I/O return 
code back to the remote application, and option 3 will cancel the display 
station pass-through session. Refer to the System Messages manual for an 
explanation of this message. 
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• It is possible that an error message could be issued by the local system 
concerning the user program running at the remote system. If this message has 
options 2 and 3 that result in the end of the step or end of the job, it will be the 
display station pass-through session that is ended rather than the remote user 
program. 

• Print key and the print operation processing both issue a read display. If you 
are in non-pass-through mode and a read display was rejected, it would be 
treated as a permanent error and the printer output would not be generated. If 
this occurred during a pass-through session, the read display would be saved in 
the reject file and would be processed later when the Error Reset key was 
pressed. The printer output would be generated in this case. 

• Option 2 win be suppressed for double-byte character set support (DECS) 
messages SYS—5497, SYS—5498, and SYS—5499. If you take this option 
during a non-pass-through session, you will get an error code back to the user 
program. This error code will not be returned during a pass-through session. 

• SYS—5490 will be issued if you try to get input from a DECS display that is 
missing a shift-in character at the end of a field. 


Features While in Display Station Pass-Through 

While on the local system, you may access a feature that is installed on the remote 
system but not on the local system, if the local system has the necessary hardware 
to support the feature. For example, if DW/36 is on the remote system but not on 
the local system, and the work station controller on the local system supports text, 
you may access DW/36 from the source display while in display station 
pass-through. 
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Error Handling 


Display station hardware and programming error messages while in pass-through 
mode are sent to the system console at the local system. If you select option 2 in 
response to the error message on the system console, the program running on the 
remote system will be given a permanent 1/O error return code. If option 3 is 
taken, the display station pass-through session will be ended. 

Error message SYS—4704 is issued by the source program whenever a permanent 
communications error occurs. This message contains a 2-byte return code to aid 
you in identifying the type of error. Only options 2 and 3 are available; both end 
the pass-through session. 

If the pass-through session is running on a nonswitched line, and the line attached 
to the primary location disconnects while the line attached to the secondary 
location remains intact, the secondary location may remain unaware of the error 
situation. If this occurs during a pass-through session, the following occurs: 

• The display appears as if it were hung if the source side is the secondary 
location. You are still able to process system inquiry at the local system to 
cancel the pass-through session. 

• The pass-through logical displays remain on the remote system if the target 
side is the secondary location. The displays can be removed by canceling the 
target program. 


G-6 Using S/36 Communications 



I Signing Off a Display Station Pass-Throi^ Session 


I You can drop or hold a pass-through session by using the OFF command. 

I • Following is the syntax of the OFF command. 

OFF r DROP 1 
L HOLD J 

I The OFF DROP or OFF command signs you off the remote system and ends the 

1 pass-through session. At this time, the command display of the local system 

I reappears. 

I The OFF HOLD command signs you off the remote system, but does not end the 

I pass-through session. At this time, the sign-on display of the remote system 

I reappears. 


I Varying Off a Display Station Pass-Through Session 

I You can end a Display Station Pass-Through session by using the VARY OFF 

I command. Following is the syntax of the VARY OFF command: 

I VARY OFF,display station ID 

I You can vary off a pass-through session just as you do a remote display. However, 

I unlike the remote, pass-through sessions can be varied off only one at a time by 

I specifying the display station pass-through ID on the VARY OFF command. If the 

I line is being shared by remote devices as well as pass-through sessions, and if that 

I line is varied off, then only the signed-off remote devices will be varied off. The 

I pass-through sessions will remain intact. These pass-through sessions cannot be 

I reestablished with the VARY ON command; they can only be restarted with the 

I PASSTHRU procedure. 

I A pass-through session cannot be varied off while you are signed on to the remote 

I system. The CANCEL session command can be used to cancel the pass-through 

I session while you are signed on. 

I If neither of these commands remove the pass-through session, all pass-through 

I sessions can be varied off by canceling the target program running at the remote 

I system. 
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I Appendix H. X.21 Short Hold Mode 


I X.21 short hold mode (SHM) with Single Port Sharing (SPS) is the sharing of an 

I X.21 circuit-switched connection by one or more remote controllers or subsystems. 

I SHM is characterized by a series of connections and disconnections with each 

I remote device on a line. Where there is no data traffic, the data link connection is 

I broken, but the SNA session remains intact. When either side has data to send, the 

I connection is re-established. 

I In some cases, you may be able to reduce line usage, which could cut your 

I communications costs in countries where Postal Telephone and Telegraph (PTT) 

1 tariffs are based on the amount of time that an X.21 line is in use. 

I X.21 SHM with SPS is application-sensitive; it is intended to be used only with 

I interactive applications that require short periods of data traffic and long periods of 

I inactivity. X.21 SHM may not be cost-effective with batch applications if they are 

I run for long periods of time on a periodic basis. 


I Configuring X.21 Short Hold Mode 


I Procedures 


The following procedures must be run to configure X.21 SHM; 

• SETCOMM defines the line as an X.21 SHM line. 

— SETCOMM should be run before the other procedures. 

— The lines must be configured with NRZI=NO for SHM. 

• ALTERCOM changes an X.21 SHM line configuration to X.21 switched until 
Initial Program Load (IPL). After IPL, the line defaults to SHM. 

• DEFINX21 sets the local system’s X.21 SHM timers, retries, and other 
configuration information for a particular line. 

• CNFIGSSP configures the remote 5294 phone numbers for remote work 
stations for X.21 SHM. This is for RWS only. 

• CNFIGICF configures the remote subsystem phone number and node ID for 
ICF-Peer or Upline support for X.21 SHM. 
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I XIDNodelD 


I The XID node ID is used on each connection and reconnection to verify the caller 

I or called device’s identity. The node ID for: 

I . The local system is defined via DEFINX21 SHM. 

I • A remote ICF-Peer or Upline subsystem is defined via CNFIGICF. 

I • A remote 5294 is the SDLC station address. 

I The node ID and dial digits defined by the system for the remote device must agree 

I with those received from the remote device in the XID, or an error will occur. 

I Rules for All Devices on an X.21 SHM Line 

I • No two call-retry delays should be configured with the same value on a line. 

1 The system and remote devices must all have different values. Use DEFINX21 

I for setting the local system call delay. 

I • The primary or the host system should have the shortest call-retry delay of all 

I the devices on a line. 

I • If multiple remote controllers are on a line, then the number of call retries for 

1 all devices must be large (something greater than 15), or number busy errors 

I (CPS21) will result in the loss of sessions. (The more devices on a line, the 

I greater the number of call retries). 

I • If the number of call retries is restricted to a small value (less than 15), it may 

I not be feasible to allow multiple remote controllers per line. 
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I Special Subsystem Considerations for an X.21 SHM Line 

1 Only one subsystem is allowed per line. 


1 • Remote work stations; Multiple remote 5294s are allowed per line. 

I Note: The R WS auto-reconnect function provides for automatic retries at the 

I SNA level after an error. In the case of a subsequent call error after the 

I initial connection, the auto-reconnect function may force the link level to 

I retry a failed call more than the PTT's allowable maximum of call retries 

I for that country. The auto-reconnect function will thus override the call 

I retries set during configuration for X.21 SHM. 

I • ICF-Peer; Multiple remote subsystems are allowed per line; however, this 

I depends on the customer applications being used. ICF-Peer applications are 

! batch and should not be used on a SHM line with other batch applications. 


• SNA Upline (MSRJE, SNUF, 3270 Device Emulation): Special 
Considerations—See “DEFINX2r’ in Chapter 5. 

Note: APPC does not run on an X.21 SHM line. 


I Initial Connection Call Failure 

I If the initial call fails when a primary or secondary subsystem is enabled or when a 

I remote work station is varied on, the system will wait for a call from the remote 

I device. 

I For example, a customer may vary on all the remote 5294 controllers for a line 

I even though none of them are powered on. All calls will fail, and the system will 

I go into answer mode. As remote devices are powered on later in the day the calls 

I will be accepted by the system. 
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Network Facilities 


Some network facilities are incompatible with X.21 SHM. 

No facility should be chosen for SHM if it prevents incoming and outgoing calls at 
the local or remote system or controller. 

The connect-when-free facility should not be used with X.21 SHM when there are 
multiple remote controllers configured for the same line. If it is used, sessions may 
be lost during peak traffic periods. With a single remote 5294 configured for a line, 
the connect-when-free facility may be chosen, although it may increase network 
charges. 


Workload Balancing 

If there is more than one X.21 SHM line available and if multiple remote 
controllers are used on each line, then an attempt at workload balancing should be 
made as follows: 

• To determine traffic per line, use the Error Recovery Analysis Procedure 
(ERAP) for SDLC, and look at the total number of transmitted and received 
I-frames. 

For more information on ERAP, refer to the System Reference manual. 

• To determine call collisions and retries for a line, use ERAP for X.21. 

• To determine traffic and calls per remote controller, use ERAP for each remote 
work station controller. 

In order to improve response time on slower lines, all of the traffic and call 
collisions and call retries should be equally distributed across all lines if possible. 


International and National/R^onal Considerations 

All remote 5294s configured for an X.21 SHM line must be able to call the 
System/36 using the same phone number. (The system’s local phone number is 
configured with DEFINX21.) This means that international calls (which require a 
country code prefix) may not be received on the same line as national calls. The 
user must check with the PTT on this subject. 

One solution is to place all international remote devices on one line and all remote 
devices within the host system’s country on a separate line. 

If the PTT allows the dial digits to be preceded by its country code prefix, then it is 
possible to put all remote devices on a single line. Check with the PTT to make 
sure that all calls will not be charged as international calls. 

If the country contains regional codes, then the same considerations may apply 
within the host system’s country. 
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Glossary 


#LIBRARY. The library, provided with the system, that 
contains the System Support Program Product. 

abnormal termination. A system failure or operator action 
that causes a job to end unsuccessfully. 

access method. The way that records in files are referred 
to by the system. The reference can be consecutive 
(records are referred to one after another in the order in 
which they appear in the file), or it can be random (the 
individual records can be referred to in any order). 

acknowledgment character (ACK). In binary synchronous 
communications, a transmission control character sent as a 
positive response to a data transmission. 

ACKO. In binary synchronous communications, the 
even-numbered positive acknowledgment character. See 
acknowledgment character (ACK). 

ACKl. In binary synchronous communications, the 
odd-numbered positive acknowledgment character. See 
acknowledgment character (ACK). 

acquire. To assign a display station or session to a 
program. 

acquired session. A session that has been started by a 
System/36 program using an acquire operation, or in 
BASIC, using an OPEN statement. 

adapter. See communications adapter. 

address pool. In data communications, a collection of 
multipoint addresses. Each address can be associated with 
an individual SSP-ICF session. 

addressii^. (1) In data communications, the way that the 
sending or control station selects the station to which it is 
sending data. (2) A means of identifying storage 
locations. 

advanced program-to-program communications (APPC). 

Communications support that allows System/36 to 
communicate with other systems having the same support. 
APPC is the way that System/36 puts the IBM SNA 
LU-6.2 protocol into effect. 


alert. An error message sent to the system services 
control point (SSCP) at a host system. On System/36, 
the problem management portion of the Communications 
and Systems Management feature is used to generate and 
send alerts. 

aUocate. To assign a resource, such as a disk file or a 
diskette file, to perform a specific task. 

alphabetic character. Any one of the letters A through Z 
(uppercase and lowercase). Some program products 
extend the alphabet to include the special characters #, $, 
and @. 

alphameric. Consisting of letters, numbers, and often 
other symbols, such as punctuation marks and 
mathematical symbols, 

alphanumeric. See alphameric. 

American National Standard Code for Information 
Interchange (ASCII). The code developed by ANSI for 
information interchange among data processing systems, 
data communications systems, and associated equipment. 
The ASCII character set consists of 7-bit control 
characters and symbolic characters. 

American National Standards Institute (ANSI). An 
organization sponsored by the Computer and Business 
Equipment Manufacturers Association for establishing 
voluntary industry standards. 

ANSI. See American National Standards Institute (ANSI). 

APAR. See authorized program analysis report (APAR). 

APPC. See advanced program-to-program communications 
(APPC). 

application program. A program used to perform an 
application or part of an application. 

ASCII. See American National Standard Code for 
Information Interchange (ASCII). 

assembler. A program that converts assembler language 
statements to machine instructions. 
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assembler instruction statement. A statement that controls 
what the assembler does, rather than what the user 
program does. 

assembler language. A symbolic programming language in 
which the set of instructions includes the instructions of 
the machine and whose data structures correspond directly 
to the storage and registers of the machine. 

asynchronous transmission. In data communications, a 
method of transmission in which the bits included in a 
character or block of characters occur during a specific 
time interval. However, the start of each character or 
block of characters can occur at any time during this 
interval. Contrast with synchronous transmission. 

attribute. A characteristic. For example, an attribute for 
a displayed field could be blinking. 

authorized program analysis report (APAR). A request for 
correction of a defect in a current release of an 
IBM-supplied program. 

autoanswer. In data communications, the ability of a 
station to receive a call over a switched line without 
operator action. Contrast with manual answer. 

autocall. In data communications, the ability of a station 
to place a call over a switched line without operator 
action. Contrast with manual call. 

autocall unit. A common carrier device that allows 
System/36 to automatically call a remote location. 

I automatic reconnect. An option specified during system 
I configuration that allows a remote work station controller 
I to be reconnected automatically on a switched or 
I nonswitched line. 

BASIC (beginner’s all-purpose symbolic instruction code). 

A programming language designed for interactive systems 
and originally developed at Dartmouth College to 
encourage people to use computers for simple 
problem-solving operations. 

1 basic data exchange. A file format for exchanging data on 
I diskettes between systems or devices. 

batch. Pertaining to activity involving little or no operator 
action. Contrast with interactive. 

hatch BSC. The System Support Program Product 
support that provides data communications with BSC 
computers and devices via the RPG T specification or the 
assembler $DTFB macroinstruction. 

batch processing. A processing method in which a 
program or programs process records with little or no 
operator action. Contrast with interactive processing. 


binary. (1) Pertaining to a system of numbers to the base 
two; the binary digits are 0 and 1. (2) Involving a choice 
of two conditions, such as on-off or yes-no. 

binary synchronous communications (BSC). A form of 
communications line control that uses transmission control 
characters to control the transfer of data over a 
communications line. Compare with synchronous data link 
control (SDLC). 

bind command. An SNA command used to define the 
protocols for a session. Contrast with unbind command. 

bit. Either of the binary digits 0 or 1. See also byte. 

bps. Bits per second. 

BSC. See binary synchronous communications (BSC). 

BSCEL (binary synchronous communications equivalence 
link) subsystem. The SSP-ICF subsystem that provides 
BSC communications with another System/36 and many 
other BSC computers and devices. 

buffer. (1) A temporary storage unit, especially one that 
accepts information at one rate and delivers it at another 
rate. (2) An area of storage, temporarily reserved for 
performing input or output, into which data is read or 
from which data is written. 

byte. The amount of storage required to represent one 
character; a byte is 8 bits. 

C & SM. See Communications and Systems Management 
(C & SM). 

I cable thru. A standard function or special feature that 
I allows multiple work stations to be attached to a particular 
I line. 

call. (1) To activate a program or procedure at its entry 
point. Compare with load. (2) In data communications, 
the action necessary in making a connection between two 
stations on a switched line. 

cancel. To end a task before it is completed. 

carrier. A continuous frequency that can be modulated 
with a second (information-carrying) signal. 

CCITT. Consultative Committee on International 
Telegraphy and Telephone. 

CCP. See communications control program (CCP). 

CCP subsystem. The SSP-ICF subsystem that provides 
data communications with a System/3 Model 15D. 
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chain. (1) A group of logically linked records. (2) In 
SNA, a group of logically linked records that are 
transferred over a communications line. 

I change man^ement. The part of the Communications 
I and Systems Management feature that allows a host 
I system operator to send (via DSX) programming changes 
I and new programs to System/36, and to start procedures 
I on System/36. 

character. A letter, digit, or other symbol. 

character key. A keyboard key that allows the user to 
enter the character shown on the key. Compare with 
command key and function key. 

CICS subsystem. The SSP-ICF subsystem that allows 
binary synchronous communications with CICS/VS. 

CICS/VS. Customer Information Control System, which 
operates on a host system such as a System/370, or a 
30XX or 43XX processor. 

clocking. In data communications, a method of 
controlling the number of data bits sent on a 
communications line in a given time. 

close. To end the processing of a file. 

COBOL (common business-oriented language). A 
high-level programming language, similar to English, that 
is used primarily for commercial data processing. 

code. (1) Instructions for the computer. (2) To write 
instructions for the computer. Same as program. (3) A 
representation of a condition, such as an error code. 

I command. A request to the system to perform an 
I operation or a procedure. 

I command key. A keyboard key that is used to request 
I specific programmed actions. Compare with character key 
I and function key. 

common carrier. In data communications, any 
government-regulated company that provides 
communication services to the general public. 

communications. See data communications. 

communications adapter. A hardware feature that enables 
a computer or device to become a part of a data 
communications network. 

I Communications and Systems Management (C & SM). A 
I feature of the System Support Program Product that 
I contains the remote management support (also referred to 
I as DHCF), the change management support (referred to 
1 as DSNX), and the problem management support 
I (referred to as alerts). 


communications control program (CCP). An IBM 
System/3 Model 15 program that allows communications 
between System/3 and the SSP-ICF CCP subsystem. 

communications file. A file that describes an advanced 
program-to-program communications (APPC) subsystem 
session between a System/36 program and a remote 
device, another program, or another system. 

communications file definition. The format in the 
communications file that contains the APPC subsystem 
session description. 

communications line. The line over which data 
communications takes place; for example, a telephone line. 

communications link. See data link. 

conununications security. A System Support Program 
Product option that allows the identity of a remote 
location to be verified before that location can run 
programs on your system. 

communications subsystem. See subsystem. 

compress. (1) To move files, libraries, or folders together 
on disk to create one continuous hrea of unused space. 

(2) To replace repetitive characters in a file or folder with 
control characters so that the file or folder takes up less 
space when saved on diskette. ^ 

compression. In data communica|tions, a technique for 
removing strings of duplicate chajracters and for removing 
trailing blanks before transmitting data. 

condition. An expression in a program or procedure that 
can be evaluated to a value of either true or false when the 
program or procedure is running. 

configuration. The group of machines, devices, and 
programs that make up a data processing system. See also 
system configuration. 

configuration member. (1) A library member that 
describes the devices, programming, and characteristics of 
the system. (2) In data communications, a member that 
defines the attributes of a communications subsystem or 
line. 

configure. (1) To describe (to the system) the devices, 
optional features, and program products installed on a 
system. (2) To describe to SSP-ICF both the 
communications facilities connected to System/36 and the 
attributes of the subsystem and remote system. 

constant. A data item with a value that does not change. 
Contrast with variable. 
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control station. The primary or controlling computer on a 
multipoint line. The control station controls the sending 
and receiving of data. 

control storage. Storage in the computer that contains the 
programs used to control input and output operations and 
the use of main storage. Contrast with main storage. 

current library. The first library searched for any required 
members. The current library can be specified during 
sign-on or while running programs and procedures. 

I cursor. A movable symbol on a display, used to indicate 
I to the operator where to type the next character. 

data area. A storage area used by a program or device to 
hold information. 

data circuit-terminating equipment (DCE). The equipment 
installed at the user’s location that provides all the 
functions required to establish, maintain, and terminate a 
connection, and the signal conversion and coding between 
the data terminal equipment (DTE) and the line. 

data communications. The transmission of data between 
computers and/or remote devices (usually over a long 
distance). 

Data Encryption Subroutine. A feature of the System 
Support Program Product that codes and decodes data for 
security purposes. This subroutine is only used by the 
SSP-ICF Finance subsystem. 

data link. The equipment and rules (protocols) used for 
sending and receiving data. 

data link escape (DLE) character. In BSC, a transmission 
control character usually used in transparent text mode to 
indicate that the next character is a transmission control 
character. 

I data manj^ement. See disk data management. 

data mode. In data communications, a time during which 
BSC is sending or receiving characters on the 
communications line. 

data stream. All information (data and control 
information) transmitted over a data link. 

data terminal equipment (DTE). The data processing unit 
that uses communications lines. 

DCE. See data circuit-terminating equipment (DCE). 

DDFF. See Distributed Disk File Facility (DDFF). 

DDM. See Distributed Data Management (DDM). 


debug. To detect, locate, and remove errors from a 
program. 

I decimal. (1) Pertaining to a system of numbers to the 
I base ten; decimal digits range from 0 through 9. (2) A 
I proper fraction in which the denominator is a power of 
I ten. 

default. See default value. 

default value. A value stored in the system that is used 
when no other value is specified. 

define-the-file (DTF). A control block containing 
information that is passed between data management 
routines and users of the data management routines. 

delete. To remove. For example, to delete a file. 

demodulate. To set a modulated signal to its original 
state. 

I DHCF. See Distributed Host Command Facility (DHCF). 

disable. In interactive communications, to end a 
subsystem and free the area of main storage used by that 
subsystem. Contrast with enable. 

DISC. Disconnect. 

I disk data management. The System Support Program 
I Product support that processes a request to read or write 
I data. 

disclosure. The act of making known or public. 

disconnect (DISC) character. In data communications, the 
part of the BSC transmission control sequence for ending 
the connection on a switched line. 

display. (1) A visual presentation of information on a 
display screen. (2) To show information on the display 
screen. 

display format. Data that defines (or describes) a display. 

display station. A device that includes a keyboard from 
which an operator can send information to the system and 
a display screen on which an operator can see the 
information sent to or the information received from the 
system. 

I Display Station Pass-Through (DSPT). A communications 
I feature that allows a user to sign on to one System/36 
I from another System/36 and access that remote system’s 
I resources. 
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Display Write/36 (DW/36). A program product that 
creates, revises, views, and prints documents that are 
produced in an office environment. 

Distributed Data Management (DDM). A feature of the 
System Support Program Product that allows an 
application program to work on files that reside on a 
remote system. 

Distributed Disk FUe Facility (DDFF). A feature of the 
System Support Program Product that allows a System/3 
or System/3 4 with DDFF to access disk files on 
System/36. 

I Distributed Host Command Facility (DHCF). Another 
I name for the remote management support offered by the 
I Communications and Systems Management feature. This 
I support allows HCF host system users to operate 
I System/36s in an HCF network. 

Distributed Systems Executive (DSX). A program product 
available for IBM host systems (System/370, 43XX, and 
30XX) that allows the host system to get, send, and 
remove files, programs, formats, and procedures in a 
network of computers. 

I Distributed Systems Node Executive (DSNX). Another 
I name for the change management support offered by the 
I Communications and Systems Management feature. This 
1 support processes changes sent by a DSX host system. 

DLE. See data link escape (DLE) character. 

DSNX. See Distributed Systems Node Executive (DSNX). 

I DSPT. See Display Station Pass-Through (DSPT). 

DSX. See Distributed Systems Executive (DSX). 

DTE. See data terminal equipment (DTE). 

duplex. Pertains to communications in which data can be 
sent and received at the same time. Same as full duplex. 
Contrast with half duplex. 

EBCDIC. See extended binary-coded decimal interchange 
code (EBCDIC). 

EBCDIC character. Any one of the symbols included in 
the 8-bit EBCDIC set. 

eight-line communications adapter/attachment (ELCA). A 
feature that allows up to eight communication lines to be 
connected to a 5360 System Unit. 

ELCA. See eight-line communications adapter/attachment 
(ELCA). 

emulation. Imitation; for example, the imitation of a 
computer or device. 


enable. In interactive communications, to load and start a 
subsystem. Contrast with disable. 

end-of-text (ETX) character. In binary synchronous 
communications, the transmission control character used 
to end a logical set of records that began with the 
start-of-text character. 

end-of-transmission (EOT) character. In binary 
synchronous communications, the transmission control 
character usually used to end communications. 

end-of-tran$mission-block (ETB) character. In binary 
synchronous communications, the transmission control 
character used to end a block of records that began with 
the start-of-text character. 

ENQ. See enquiry (ENQ) character. 

enquiry (ENQ) character. In binary synchronous 
communications, the transmission control character 
usually used to request a response from the remote system 
or device. 

enter. To type in information from a keyboard and press 
the Enter key in order to send the information to the 
computer. 

EOT. See end-of-transmission (EOT) character. 

I ERAP. See error recording analysis procedure (ERAP). 

error code. See system reference code. 

[ error recording analysis procedure (ERAP). An 
I IBM-supplied program that processes and presents 
I recorded errors related to the devices (disk, for example) 

I of the system. 

ETB. See end-of-transmission-block (ETB) character. 

ETX. See end-of-text (ETX) character. 

I evoke. To start a program or procedure so that it can 
I communicate with your program. 

expression. A representation of a value. For example, 
variables and constants appearing alone or in combination 
with operators. 

extended binary-coded decimal interchange code 
(EBCDIC). A set of 256 eight-bit characters. 

I feature. A programming or hardware option, usually 
I available at an extra cost. For example. Communications 
I is a feature of the System Support Program Product. 

field. One or more characters of related information 
(such as a name or an amount). 
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fUe. A set of related records treated as a unit. 

file name. The name used by a program to identify a file. 
See also label. 


high-level data link control (HDLC). Control of data links 
by use of a specified series of bits rather than by the 
control characters of the ISO Standard 7-bit character set 
for information processing interchange. 


Finance subsystem. The SSP-ICF subsystem that allows 
System/36 to communicate with the 3601 and 4701 
Finance Controllers and the 3694 Document Processor. 

I first-level message. A message that is issued immediately 
I when an error occurs. 

I folder. A named area on disk that contains documents, 

I profiles, mail, or data definitions. Compare with library. 

format. (1) A defined arrangement of such things as 
characters, fields, and lines, usually used for displays, 
printouts, files, or documents. (2) To arrange such things 
as characters, fields, and lines. (3) In BASIC, a 
representation of the correct form of a command or 
statement. (4) In IDDU, a group of related fields, such as 
a record, in a file. 


full duplex. Same as duplex. 


/ 

function key. A keyboard key that requests an action but 
does not display or print a character. The cursor 
movement and Help keys are examples of function keys. 
Compare with command key and character key. 


I Host Command Facility (HCF). A feature available for 
I IBM host systems (System/370, 43XX, and 30XX) that 
I allows host system users to operate System/36s from their 
I 3270-type display stations as though they were using 
I remotely attached 5250-type display stations. 

host system. The primary or controlling computer in a 
communications network. See also control station. 

I/O. See input/output (I/O). 

I IBM PC. An IBM personal computer; for example, an 
I IBM Personal Computer AT. 

ID. Identification. 

identifier. (1) A sequence of bits or characters that 
identifies a program, device, or system to another 
program, device, or system. (2) In COBOL, a data name 
that is unique or is made unique by the correct 
combination of qualifiers, subscripts, or indexes. (3) In 
PS/36, a name that identifies the type of member in a 
group. The identifier can be a calendar, a user ID, or 
another group. 


function management header. In Sl^A, a special record or 
part of a record that contains control information for the 
data that follows. 

generation. For some remote systems, the translation of 
configuration information into machine language. 

half duplex. Pertains to communications in which data 
can be sent in only one direction at a time. Contrast with 
duplex. 

HCF. See Host Command Facility (HCF). 

HDLC. See high-level data link control (HDLC). 


IF expressions. Expressions within a procedure that are 
used to test for a condition. 

IGS. See interchange group separator (IGS). 

informational message. A message that provides 
information to the operator, but does not require a 
response. 

initial program load (IPL). The process of loading the 
system programs and preparing the system to run jobs. 

initialize. To prepare for use. For example, to initialize a 
diskette. 


Help key. A function key that, when pressed, displays 
online information or some part of the system help 
support. 

I help text. The part of the system help support that offers 
I additional information about displays and messages. 

hex. See hexadecimal. 

hexadecimal. Pertaining to a system of numbers to the 
base sixteen; hexadecimal digits range from 0 (zero) 
through 9 (nine) and A (ten) through F (fifteen). 


Input. Data to be processed. 

input/output (I/O). Pertaining to either input or output, 
or both. 

inquiry. (1) A request for information in storage. (2) A 
request that puts a display station into inquiry mode. (3) 
In data communications, a request for information from 
another system. 

interactive. Pertaining to activity involving requests and 
replies as, for example, between an operator and a 
program or between two programs. Contrast with batch. 
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Interactive Communications Feature (SSP-ICF). A feature 
of the System Support Program Product that allows a 
program to interactively communicate with another 
program or system. 

interactive processing. A processing method in which each 
operator action causes a response from the program or the 
system. Contrast with batch processing. 

interchange group separator (IGS). A character used to 
indicate that blanks have been removed from a string of 
data and are to be reinserted. 

intermediate block check. In binary synchronous 
communications, an option that permits checking each 
record, instead of checking the contents of the total 
buffer, when large buffers of data are received. 

intermediate-text-block (ITB) character. In binary 
synchronous communications, the transmission control 
character used to indicate the end of a section of data to 
be checked. See intermediate block check. 

interrupt. (1) To temporarily stop a process. (2) In data 
communications, to take an action at a receiving station 
that causes the sending station to end a transmission. 

Intra subsystem. An SSP-ICF subsystem that enables 
programs to communicate with other programs on the 
same system without the use of communication lines. 

I intrinsic. Belonging to the essential nature of a thing. 

invite. To ask for input data from either a display station 
or an SSP-ICF session. 

IPL. See initial program load (IPL). 

IRS (interchange record separator). Same as record 
separator. 

ITB. See intermediate-text-block (ITB) character. 

job. (1) A unit of work to be done by a system. (2) One 
or more related procedures or programs grouped into a 
procedure. 

job step. A unit of work represented by a single program 
or a procedure that contains a single program. A job 
consists of one or more job steps. 

K-byte. 1024 bytes. 

key. One or more characters used to identify the record 
and establish the record’s order within an indexed file. 

label. (1) The name in the disk or diskette volume table 
of contents or on a tape that identifies a file. See also file 
name. (2) The name that identifies a statement. 


left-adjust. To place or move an entry in a field so that 
the leftmost character of the field is in the leftmost 
position. Contrast with right-adjust. 

I library. (1) A named area on disk that can contain 
I programs and related information (not files). A library 
I consists of different sections, called library members. 

I Compare with folder. (2) The set of publications for a 
I system. 

library member. A named collection of records or 
statements in a library. The types of library members are 
load member, procedure member, source member, and 
subroutine member. 

library member subtype. A specific classification of a 
library member type. For example, a source member can 
be identified as a COBOL source member or a DFU 
source member. 

licensed progpram. An IBM-written program that performs 
functions related to processing user data. 

link level. A part of Recommendation X.25 that defines 
the link protocol used to get data into and out of the 
network across the full-duplex link connecting the 
subscriber’s machine to the network node. LAP and 
LAPB are the link access protocols recommended by the 
CCITT. 

link protocol. See link level. 

I load. (1) To move data or programs into storage. (2) To 
I place a diskette into a diskette drive or a diskette 
I magazine into a diskette magazine drive. (3) To insert 
I paper into a printer. (4) To mount a tape or insert a tape 
I cartridge into a tape drive. 

load member. A library member that contains information 
in machine language, a form that the system can use 
directly. Contrast with source member. 

local. Pertaining to a device, file, or system that is 
accessed directly from your system, without the use of a 
communications line. Contrast with remote. 

location name. In interactive communications, the 
identifying name associated with a particular system or 
device. 

log. To record; for example, to log all messages on the 
system printer. 

logical channel. In a packet switching data network, a 
path over which data packets flow between the sending 
data terminal equipment and the network, and between 
the network and the receiving data terminal equipment. 
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logical unit (LU). The part of a system or device in an 
SNA network that allows a user or program to use the 
communications network. 

LU. See logical unit (LU). 

macro. See macroinstruction. 

macroinstruction. A single instruction that represents a set 
of instructions. 

main storage. The part of the processing unit where 
programs are run. Contrast with control storage. 

manual answer. In data communications, a line type 
requiring operator actions to receive a call over a switched 
line. Contrast with autoanswer. 

manual caU. In data communications, a line type requiring 
operator actions to place a call over a switched line. 
Contrast with autocall. 

I master configuration record. Information, stored on disk, 

I that describes system devices, programming, and 
I characteristics. 

member. See library member. 

menu. A displayed list of items from which an operator 
can make a selection. 

message. (1) Information sent to one or more users or 
display stations from a program or another user. A 
message can be either displayed or printed. (2) An 
indication of the condition of the system sent by the 
system. (3) For IMS/IRSS, a unit of data sent over the 
communications line. 

message identification. A field in the display or printout of 
a message that directs the user to the description of the 
message in a message guide or a reference manual. This 
field consists of up to four alphabetic characters, followed 
by a dash, followed by the message identification code. 

message identification code (MIC). A four-digit number 
that identifies a record in a message member. This 
number can be part of the message identification. 

MIC. See message identification code (MIC). 

MLCA. See multiline communications adapter/attachment 
(MLCA). 

mode. A method of operation. 

modem. See modulator-demodulator (modem). 

modulation. Changing the frequency or size of one signal 
by using the frequency or size of another signal. 


modulator-demodulator (modem). A device that converts 
data from the computer to a signal that can be transmitted 
on a communications line, and converts the signal received 
to data for the computer. 

module. One part of a program, which usually performs a 
specific task (such as disk input/output). 

monitor. Programming or hardware that observes, 
supervises, controls, or verifies the operation of a system. 

MRT procedure. See multiple requester terminal (MRT) 
procedure. 

MRT program. See multiple requester terminal (MRT) 
program. 

MSRJE. See Multiple Session Remote Job Entry 
(MSRJE). 

multiline communications adapter/attachment (MLCA). A 

feature that allows up to four communication lines to be 
connected to System/36. 

multiple. More than one. 

multiple requester terminal (MRT) procedure. A 
procedure that calls a multiple requester terminal program. 

multiple requester terminal (MRT) program. A program 
that can process requests from more than one display 
station or SSP-ICF session at the same time using a single 
copy of the program. Contrast with single requester 
terminal (SRT)program. 

Multiple Session Remote Job Entry (MSRJE). A feature 
of the System Support Program Product that allows one or 
more remote job entry sessions to operate on a host 
system (such as a System/370, or a 30XX or 43XX 
processor) at the same time. 

multipoint. In data communications, pertains to a network 
that allows two or more stations to communicate with a 
single system on one line. 

NAK. See negative acknowledgment character (NAK). 

negative acknowledgment character (NAK). In binary 
synchronous communications, a transmission control 
character sent as a negative response to data received. 

negative response. In data communications, a reply 
indicating that data was not received correctly or that a 
command was incorrect or unacceptable. 

NEP. See never-ending program (NEP). 
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network. A collection of data processing products 
connected by communications lines for information 
exchange between stations. 

never-ending program (NEP). A long-running program 
that does not share system resources, except for shared 
files and the spool file. 

node. (1) An addressable location in a communications 
network that provides host processing services. (2) A 
point where packets are received, stored, and forwarded to 
another node (or DTE) according to a routing method the 
network has defined. 

non-return-to-zero inverted (NRZI). On System/36, a 
method of data transmission where the signal is changed 
to transmit a 0 bit. For the 1 bit the signal stays the same. 
This ensures that the signal does not stay the same for an 
extended period of time. 

nonswitched line. A connection between computers or 
devices that does not have to be established by dialing. 
Contrast with switched line. 

NRZI. See non-return-to-zero inverted (NRZI). 

null character. The character hex 00, used to represent 
the absence of a displayed or printed character. 

null record. In binary synchronous communications, a 
record that contains no data; only the data link control 
characters STX ETX. 

numeric. Pertaining to any of the digits 0 through 9. 

OCL. See operation control language (OCL). 

offline. Neither controlled directly by, nor communicating 
with, the computer, or both. Contrast with online. 

online. Being controlled directly by, or directly 
communicating with, the computer, or both. Contrast 
with offline. 

open. To prepare a file for processing. 

operation. A defined action, such as adding or comparing, 
performed on one or more data items. 

operation code. (1) A code used to represent the 
operations of a computer. (2) In SSP-ICF, a code used by 
a System/36 application program to request SSP-ICF data 
management and/or the subsystem to perform an action. 
For example, the operation $$SEND asks that data be 
sent. 

operation control language (OCL). A language used to 
identify a job and its processing requirements to the 
System Support Program Product. 


output. The result of processing data. 

override. ( 1 ) A parameter or value that replaces a 
previous parameter or value. (2) To replace a parameter 
or value. 

packet. A data transmission information unit. It has a 
header on the front that indicates the destination of the 
packet. Commonly used data field lengths in packets are 
128 or 256 bytes. 

packet switching. The act of transferring and routing 
packets from source to destination based on information 
contained in their headers. 

packet switching data network (PSDN). A 
communications network that uses packet switching as a 
means of transmitting data. 

packet window. A specified number of packets that can be 
sent by the DTE before it receives an acknowledgement. 

parameter. A value supplied to a procedure or program 
that either is used as input or controls the actions of the 
procedure or program. 

partner. In data communications, the remote application 
program or the remote computer. 

password. A string of characters that, when entered along 
with a user ID, allows an operator to sign on to the 
system. 

password security. A System Support Program Product 
option that helps prevent the unauthorized use of a display 
station, by checking the password entered by each 
operator at sign-on. 

Peer subsystem. The SSP-ICF subsystem that allows 
System/36 to communicate with another System/36 or 
System/34 using SNA/SDLC. 

pending. Waiting, as in an operation is pending. 

permanent virtual circuit (PVC). A virtual circuit that has 
a logical channel permanently assigned to it at each DTE. 
The usual call establishment protocol is therefore not 
required. 

Personal Services/36 (PS/36). A program product that 
can be used to send and receive mail, schedule 
appointments on calendars, maintain directories of names 
and addresses, and work with groups of users or calendars. 

phone list. A list of telephone numbers to be called using 
a communications program and the autocall or X.25 
feature. 

physical connection. See physical level (X.25) 
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physical level (X.25). A standard that defines the 
electrical, physical, functional, and procedural methods 
used to control the physical link running between the DTE 
and the DCE. 

physical record. (1) A group of records that is recorded or 
processed as a unit. (2) A unit of data that is moved into 
or out of the computer. 

point-to-point line. A communications line that connects 
a single remote station to a computer. 

poll. To execute a polling sequence. 

poUii^. A method for determining whether each of the 
stations on a communications line has data to send. 

positional parameter. A parameter that must appear in a 
specified location, relative to other positional parameters. 

procedure. A set of related operation control language 
statements (and, possibly, utility control statements and 
procedure control expressions) that cause a specific 
program or set of programs to be performed. 

procedure command. A command that runs a procedure. 

procedure member. A library member that contains the 
statements (such as operation control language 
statements) necessary to perform a program or set of 
programs. 

procedure start request. A message from the remote 
system asking an SSP-ICF subsystem to start a System/36 
procedure. 

program. (1) A sequence of instructions for a computer. 
(2) To write a sequence of instructions for a computer. 
Same as code. 

program product. A licensed program for which a fee is 
charged. 

program temporary fix (PTF). A temporary solution to or 
bypass of a defect in a current release of a licensed 
program. 

prompt. A displayed request for information or operator 
action. 

I protocol. A set of rules governing the communication and 
I transfer of data between two or more devices in a 
I communications system. 

PS/36. See Personal Services/36 (PS/36). 

PSDN. See packet switching data network (PSDN). 

PTF. See program temporary fix (PTF). 


public data network. A communications common carrier 
network that provides data communications services over 
switched or nonswitched lines. 

queue. A line or list formed by items waiting to be 
processed. 

receive time-out. In data communications, the result of no 
data being received in a given period of time. 

Reconunendation X.25. A document, CCITT 
Recommendation X.25, that outlines standards for the 
connection of processing equipment to a packet switching 
data network. 

record separator. In binary synchronous communications, 
a character used to indicate the end of one record and the 
beginning of another. 

recovery procedure. (1) An action performed by the 
operator when an error message appears on the display 
screen. Usually, this action permits the program to 
continue or permits the operator to run the next job. (2) 
The method of returning the system to the point where a 
major system error occurred and running the recent critical 
jobs again. 

remote. Pertaining to a device, file, or system that is 
accessed by your system through a communications line. 
Contrast with local. 

remotely started session. A session started by an incoming 
procedure start request from the remote system. Contrast 
with acquired session. 

request unit. In SNA, the record transmitted to the other 
system. This record can contain a request, data, or both. 

requester. A display station or interactive 
communications session that requests a program to be run. 

response unit. In SNA, the record sent to respond to a 
request. The response can be either positive or negative 
and can include control information. 

restore. Return to an original value or image. For 
example, to restore a library from diskette. 

return code. In data communications, a value generated 
by the system or subsystem that is returned to a program 
to indicate the results of an operation issued by that 
program. 

reverse charging. A packet switching data network 
optional facility. It enables the DTE to request that the 
cost of a communications session it initiates be charged to 
the DTE that is called. 
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reverse-interrupt character (RVI). In binary synchronous 
communications, a request by the receiving station to the 
sending station to stop sending and begin receiving a 
message. 

right-adjust. To place or move an entry in a field so that 
the rightmost character of the field is in the rightmost 
position. Contrast with left-adjust. 

routine. A set of statements in a program that causes the 
system to perform an operation or a series of related 
operations. 

RPG. A programming language specifically designed for 
writing application programs that meet common business 
data processing requirements. 

RU. See request unit and response unit. 

run. To cause a program, utility, or other machine 
function to be performed. 

RVI. See reverse-interrupt character (R VI). 

I RWS. Remote work station. 

SDLC. See synchronous data link control (SDLC). 

I security. The protection of data, system operations, and 
I devices from accidental or intentional ruin, damage, or 
I exposure. See also system security. 

security officer. A person who is designated to control 
many of the system security tasks that are provided with 
the System Support Program Product. A security officer 
can, for example, add, change, or remove security 
information about system console operators, subconsole 
operators, and display station operators. A security 
officer cannot, however, deactivate password, badge, or 
resource security. 

segment. A part of a program that can be run without the 
entire program being in main storage. 

sense data. In SNA, the data sent with a negative 
response, indicating the reason for the response. 

separator character. In data communications, the 
character that is used with some autocall units to separate 
the digits to be dialed. 

session. (1) The logical connection by which a System/36 
program or device can communicate with a program or 
device at a remote location. (2) The length of time that 
starts when an operator signs on the system and ends 
when the operator signs off the system. 

session group. In APPC, a number of communications 
sessions to be managed as a unit. 


SEU. See source entry utility (SEU). 

sign off. To end a session at a display station. 

s^ on. (Verb) To begin a session at a display station. 

sign-on. (Noun) The action an operator uses at a display 
station in order to begin working at the display station. 

single line communications adapter/attachment (SLCA). In 
data communications, a feature that allows a single 
communications line to be connected to System/36. 

single requester terminal (SRT) program. A program that 
can process requests from only one display station or 
SSP-ICF session from each copy of the program. 

Contrast with multiple requester terminal (MRT) program. 

SLCA. See single line communications adapter/attachment 
(SLCA). 

SNA. See systems network architecture (SNA). 

SNA Upline Facility (SNUF). The SSP-ICF subsystem 
that allows System/36 to communicate with CICS/VS 
and IMS/VS application programs on a host system. 

Also, using this subsystem, DHCF communicates with 
HCF and DSNX communicates with DSX. 

SNUF. See SNA Upline Facility (SNUF). 

SOH. See start-of-header (SOH) character. 

source entry utility (SEU). The part of the Utilities 
Program Product used by the operator to enter and update 
source and procedure members. 

source member. A library member that contains 
information in the form in which it was entered, such as 
RPG specifications. Contrast with load member. 

SRT program. See single requester terminal (SRT) 
program. 

SSP. See System Support Program Product (SSP). 

SSP-ICF. See Interactive Communications Feature 
(SSP-ICF). 

start-of-header (SOH) character. In binary synchronous 
communications, the transmission control character 
indicating that the information that follows is a header. 

start-of-text (STX) character. In binary synchronous 
communications, a transmission control character used to 
begin a logical set of records that will be ended by the 
end-of-text character or end-of-transmission-block 
character. 

statement. An instruction in a program or procedure. 
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statement number. The number assigned to each 
specification. Comments, continued lines, F 
specifications, and unrecognized or out-of-sequence 
specifications are not assigned statement numbers. 

station. A computer or device that can send or receive 
data. 

status. A condition. For example, the status of a printer, 
a job, or a communications line. 

STX character. See start-of-text (STX) character. 

subconsole. A display station that controls a printer or 
printers. 

subroutine. A group of instructions that can be called by 
another program or subroutine. 

subroutine member. A library member that contains 
information that must be combined with one or more 
members before being run by the system. 

subsystem. The part of communications that handles the 
requirements of the remote system, isolating most 
system-dependent considerations from the application 
program. 

subtype. See library member subtype. 

switched line. In data communications, a connection 
between computers or devices that is established by 
dialing. Contrast with nonswitched line. 

switched network backup (SNBU). In data 
communications, a technique that provides a switched line 
connection when a nonswitched line fails. 

switched virtual circuit. A virtual circuit that is requested 
from the network through a virtual call. It is released 
when the virtual circuit is cleared. 

SYN. See synchronization (SYN) character. 

synchronization (SYN) character. In binary synchronous 
communications, the transmission control character that 
provides a signal to the receiving station for timing. 

synchronous. Occurring in a regular or predictable 
sequence. 

synchronous data link control (SDLC). A form of 
communications line control that uses commands to 
control the transfer of data over a communications line. 
Compare with binary synchronous communications (BSC). 


synchronous transmission. In data communications, a 
method of transmission in which the sending and receiving 
of characters is controlled by timing signals. Contrast 
with asynchronous transmission. 

system. The computer and its associated devices and 
programs. 

system configuration. A process that specifies the 
machines, devices, and programs that form a particular 
data processing system. 

I system console. A display station from which an operator 
1 can keep track of and control system operation. 

system library. The library, provided with the system, that 
contains the System Support Program Product and is 
named #LIBRARY. 

system monitor session. In SSP-ICF, a session started by 
the Finance subsystem to load the applications into a 
finance controller. 

system program. An IBM-supplied program that is 
installed on the system. The System Support Program 
Product (SSP) is an example. 

system reference code. A four-character code that 
contains information for a service representative. This 
code either is provided as part of a message or is displayed 
on the control panel. 

system security. A system function that restricts the use 
of files, libraries, folders, folder members, and display 
stations to certain users. 

System Support Program Product (SSP). A group of 
licensed programs that manage the running of other 
programs and the operation of associated devices, such as 
the display station and printer. The SSP also contains 
utility programs that perform common tasks, such as 
copying information from diskette to disk. 

system unit. The part of the system that contains the 
processing unit, the control panel, the disk drive and the 
disk, and either a diskette drive or a diskette magazine 
drive. 

systems network architecture (SNA). A set of rules for 
controlling the transfer of information in a data 
communications network. 

task. A unit of work (such as a user program) for the 
main storage processor. 

temporary-text-delay (TTD) character. A BSC 

transmission control character that indicates to the 
receiving station that there is a temporary delay in the 
transmission of data. 
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terminal. In data communications, a device, usually 
equipped with a keyboard and a display device, capable of 
sending and receiving information over a communications 
line. 

transaction. (1) An item of business. The handling of 
customer orders and customer billing are examples of 
transactions. (2) In interactive communications, the 
communication between the application program and a 
specific item (usually another application program) at the 
remote system. 

transaction code. For the IMS subsystem, the first one to 
eight characters of the first segment of a message sent to 
IMS/VS. The transaction code identifies the application 
program for which the message is intended. 

transaction fUe. A file containing data, such as customer 
orders, that is usually used only with a master file. 

transmission control characters. In data communications, 
special characters that are included in a message to control 
communication over a data link. For example, the sending 
station and the receiving station use transmission control 
characters to exchange information; the receiving station 
uses transmission control characters to indicate errors in 
data it receives. 

transparent data. Data that can contain any hexadecimal 
value. 

transparent text mode. A mode that allows BSC to send 
and receive messages containing any of the 256 character 
combinations in hexadecimal, including transmission 
control characters. 

tributary station. In data communications, a secondary 
device on a multipoint line. 

truncate. To shorten a field or statement to a specified 
length. 

TTD character. See temporary-text-delay (TTD) character. 

unbind command. An SNA command used to reset the 
protocols for a session. Contrast with bind command. 

unique. The only one. 

UPSI switch. See user program status indicator (UPSI) 
switch. 

user ID. See user identification (user ID). 

I user identification (user ID). A string of characters that 
I identifies a user to the system. 

user program status indicator (UPSI) switch. One of a set 
of eight switches that can be set by and passed between 
application programs and procedures. 


valid. (1) Allowed. (2) True, in conforming to an 
appropriate standard or authority. 

variable. A name used to represent a data item whose 
value can change while the program is running. Contrast 
with constant. 

virtual circuit. A logical connection established between 
two DTEs. It can be permanent, that is, defined when you 
subscribe to your network port, or it can be dynamically 
established when creating a switched virtual circuit. 

I volume table of contents (VTOC). An area on a disk or 
I diskette that describes the location, size, and other 
I characteristics of each file, library, and folder on the disk 
I or diskette. 

VTOC. See volume table of contents (VTOC). 

WACK. See wait-before-transmitting-acknowledgment 
character (WACK). 

wait-bef ore-transmitting-acknowledgment character 
(WACK). In BSC, the transmission control character 
indicating that the station is temporarily not ready to 
receive data. 

work station. A device that lets people transmit 
information to or receive information from a computer; 
for example, a display station or printer. 

World Trade. (1) Pertains to the distinction between the 
US and the rest of the world. (2) Pertains to the 
combination of: 

— IBM World Trade Americas/Far East 
Corporation 

— IBM World Trade Europe/Middle East/Africa 
Corporation 


X.21. In data communications, a specification of the 
CCITT that defines the connection of data terminal 
equipment to an X.21 (public data) network. 

X.21 feature. The feature that allows System/36 to be 
connected to an X.21 network. 

I X.21 short hold mode. An option specified during system 
I configuration that allows a circuit switched line to be 
I disconnected when the line is not active. 

X.25. In data communications, a specification of the 
CCITT that defines the interface to an X.25 (packet 
switching) network. 

I X.25 feature. The feature that allows System/36 to be 
I connected to an X.25 network. 
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X.75. A standard that defines ways of interconnecting 
two X.25 networks. 

3270 BSC Support subsystem. The subsystem that 
provides program-to-program communications with 
IMS/VS, CICS/VS, TSO, VM, or system application 
programs using 3270 BSC protocols, and provides support 
for the BSC portion of the 3270 Device Emulation 
feature. 


3270 Device Emulation. A feature of the System Support 
Program Product that allows a System/36 local or remote 
device to appear as a 3270 device to another system. 

3270 SNA Support subsystem. The subsystem that 
provides support for the SNA portion of the 3270 Device 
Emulation feature. 

I 3278 Device Emulation. A feature of the System Support 
I Program Product that allows a System/3 6 local or remote 
I device to appear as a 3278 device to another system. 
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Maximum number of conversations (MAXCNV 
parameter) B-13 

Maximum number of source sessions (MAXSRCSSN 
parameter) B-13 
MAXOUT parameter, GROUP 
macroinstruction B-3 
MAXSSN parameter B-13 
message type(s), SSCPFM parameter B-4 
minimum line speed (SPEED parameter) B-4 
mode entry name (MODE parameter), 
ADDDEVMODE command B-13 
modem data clock (CLOCKING parameter) B-2 
multipoint line, service order (SERVICE 
macroinstruction) B-5 
NCP VTAM generation considerations B-1 
NETNAME parameter (DFHTCT 
macroinstruction) B-8 
network control (USE parameter) B-4 
network control type (TYPE parameter) B-4 
NRZI parameter B-3 
ORDER parameter (SERVICE 
macroinstruction) B-5 
overview 9-1 

PASSLIM parameter (GROUP 
macroinstruction) B-4 

PCT (program control table), CICS VS (DFHPCT 
macroinstruction) B-8 
peer communications 9-1 
physical unit (PU) activation (ISTATUS 
parameter) B-3 
POLLED parameter (GROUP 
macroinstruction) B-4 
polling (POLLED parameter) B-4 
PPT (processing program table) B-9 
pre-established sessions, ADDDEVMODE 
command B-13 
primary stations 9-1 
processing program table (PPT) B-9 
program control table, CICS VS (DFHPCT 
macroinstruction) B-8 
remote system identifier(s) B-12 
remote system selection 9-8 
RETRIES parameter B-4 
RU size B-14 
secondary stations 9-1 
security 

ATTACH C-1 
BIND C-1 
introduction C-1 
session groups 
creating 9-12 
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describing PSDN 11-3 
naming systems 11-3 
ATTACH, security C-1 
attribute, definition W-2 

authorized program analysis report, definition W-2 
autoanswer 

SSP-ICF or remote work stations 4-9 
switch type 3-17 
autoanswer, definition W-2 
autocall 

creating connection lists using DEFINX21 
procedure 5-8 

creating connection lists using DEFINX25 
procedure 5-14 

creating phone lists using DEFINEPN 
procedure 5-5 

end of number characters, allowing 2-1 
phone list, SNA 3-17 
phone number, SNA 3-17 
separator character, allowing 2-1 
SSP-ICF 4-9 

autocall unit, definition W-2 
autocall, definition W-2 
automatic answer 2-8 
automatic reconnect, definition W-2 


B 


backup line, secondary, specifying 2-6 
balancing workloads, X.21 SHM H-4 
BASIC (beginner’s all-purpose symbolic instruction code), 
definition W-2 

basic conversations, APPC verbs F-1 
basic data exchange, definition W-2 
batch applications, SHM H-1 
batch BSC, definition W-2 
batch processing, definition W-2 
batch, definition W-2 

binary synchronous communications, definition W-2 

binary, definition W-2 

bind command, definition W-2 

BIND, security C-1 

bit, definition W-2 

blank compression, specifying 2-6 

blank fields on configuration displays 11-10 

block ID, remote SNA 3-16 

BSC 

See also binary synchronous communications 

address of local station 3-26 

autocall phone list 3-28 

buffer length 3-29 

changing a line member 3-21 
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changing parameters 

using ALTERCOM procedure 2-6 
using SETCOMM procedure 2-1 
creating a line member 3-21 
creating a line member from existing 3-21 
current library 3-20 
deleting a line member 3-21 
determining error retry count 3-25 
error retry count 3-1 
error retry count, specifying 3-25 
existing remote system name 3-28 
library used for line member 3-20 
line characteristics 3-25 
line member definition 
example 3-20 
use of 3-2 
line monitoring 

starting using STARTM procedure 7-4 
stopping using STOPM procedure 7-12 
member library name, existing 3-22 
member names, existing 3-22 
naming the line member 3-20 
nonswitched point-to-point line 3-25 
phone list for autocall 3-28 
remote system 
creating 3-27 
deleting 3-27 
editing 3-27 
removing 3-27 
reviewing 3-27 
remote system attributes 3-27 
remote system definition 
attributes 3-28 
ending 3-29 
remote system name 3-28 
reviewing a line member 3-21 
select configuration member type 3-23, 3-24 
selecting the operation, CNFIGICF 3-21 
switch type definition 3-26 
switched point-to-point line 3-25 
transmit buffer length 3-29 
viewing a line member 3-21 
BSC Configuration Member Type (3.0) display 3-24 
BSC line Member Type (10.0) display 3-25 
BSCEL 

configuration 5-2 
FTS 12-1 

BSCEL (binary synchronous communications equivalence 
link) subsystem, definition W-2 
buffer length 
BSC 3-29 
RSCS BSC 3-29 

BUFFER parameter (DFHTCT macroinstruction) for 
APPC B-8 
buffer, definition W-2 
byte, definition W-2 


c 


C&SM 

See Communications and Systems Management 
cable thru, definition W-2 
call 

definition W-2 
switch type 3-17 
call failures, X.21 SHM H-3 
call lists 

creating using DEFINX21 procedure 5-8 
creating using DEFINX25 procedure 5-14 
call setup, X.25 4-29 

CANCEL command. Display Station Pass-Through G-7 

cancel, definition W-2 

canceling 

Display Station Pass-Through session G-7 
X.21 facility using REQUESTX procedure 8-1 
carrier, definition W-2 
CCP 

See communications control program 
CCP subsystem, definition W-2 
change management, definition W-3 
changing a line member 

asynchronous communications 11-11 
BSC 3-21 
SNA 3-6 

changing communications line parameters 2-6 
character-coded messages (SSCPFM parameter) for 
APPC B-4 

character key, definition W-3 
character, definition W-3 
characteristics of the line 
BSC 3-25 
SNA 3-10 
characters 

addressing, BSC 2-13 
polling table of BSC 2-13 
CICS subsystem, definition W-3 
CICS VS (Customer Information System Virtual Storage), 
generation considerations for APPC B-7 
CICS/VS, definition W-3 

clock restriction, APPC NONRTNZ parameter B-11 
CLOCKING parameter (GROUP macroinstruction) for 
APPC B-2 

clocking, modem, specifying 

using ALTERCOM procedure 2-6 
using SETCOMM procedure 2-1 
close, definition W-3 
closing 

APPC session group 10-3 
DDM session group 10-3 

Display Station Pass-Through session group 10-3 
PS/36 document distibution function 10-3 
CNFIGICF procedure 
command 3-1 
default values 11-10 
description 11-9 
prompting facilities 11-9 
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sample values 11-10 
sequence of displays 11-9 
CNFIGICF procedure/SHM H-1 
CNFIGICF, command keys 3-6 
CNFIGSSP 

defining remote work stations 4-1 
describing System/36 environment 4-7 
CNFIGSSP procedure, for SHM H-1 
CNFIGX25 procedure 

changing line configurations 4-25 
defining X.25 configuration 4-11 
introduction 11-18 

COBOL (common business-oriented language), 
definition W-3 

COBOL file transfer subroutine, SUBRFl 12-4 
code, definition W-3 
command keys 

CNFIGICF 3-6,3-20 
definition W-3 
command, definition W-3 
common carrier, definition W-3 
communications 
autocall 

creating phone list, call list 
end of number characters, allowing 2-1 
separator characters, allowing 2-1 
call list 

creating using DEFINX21 procedure 5-8 
creating using DEFINX25 procedure 5-14 
changing parameters 

using ALTERCOM procedure 2-6 
using SETCOMM procedure 2-1 
changing settings of lines 2-2, 2-8 
clocking 2-3 
data encoding 2-3 

debugging subsystems using ICFDEBUG 
procedure 7-1 
definition W-3 

disabling subsystems using DISABLE procedure 6-3 
enabling subsystems using ENABLE procedure 6-1 
end of number characters, allowing 2-1 
line speed, changing using SETCOMM 
procedure 2-1 
line type, changing 

using ALTERCOM procedure 2-6 
using SETCOMM procedure 2-1 
line type, using SETCOMM procedure 2-2 
line, defining 

using ALTERCOM procedure 2-6 
using SETCOMM procedure 2-1 
monitoring 

using STARTM procedure 7-4 
using STOPM procedure 7-12 
multipoint line, specifying 

using ALTERCOM procedure 2-9 
using SETCOMM procedure 2-1 
nonswitched line, specifying 

using ALTERCOM procedure 2-8 
using SETCOMM procedure 2-1 
phone list 

changing using DEFINEPN procedure 5-5 


creating using DEFINEPN procedure 5-5 
point-to-point line, specifying 

using ALTERCOM procedure 2-8 
using SETCOMM procedure 2-1 
remote IDs, defining using DEFINEID 
procedure 5-1 
S/36 packaging 1-1 
separator characters, allowing 2-1 
SSP-ICF BSCEL subsystem 5-1 
start monitoring line 7-4 
stop monitoring line 7-12 
switched line, specifying 

using ALTERCOM procedure 2-6 
using SETCOMM procedure 2-1 
X.21 

canceling a facility 8-1 
requesting a facility 8-1 
X.25 line, specifying using SETCOMM 
procedure 2-1 

communications adapter, definition W-3 
Communications and Systems Management, 
definition W-3 

communications characteristics (GROUP 
macroinstruction) for APPC B-2 
communications control program, definition W-3 
communications costs, reducing H-1 
communications file definition, definition W-3 
communications file, definition W-3 
communications lines 

asynchronous communications support 11-2 
defining attributes of 11-14, 11-15 
definition W-3 
number of asynchronous 11-2 
communications link disconnection (DISCNT parameter) 
for APPC B-2 

communications link, definition W-3 
communications mode (DUPLEX parameter) for 
APPC B-3 

communications peer considerations for APPC B-1 
communications security, definition W-3 
communications subsystem, definition W-3 
compress, definition W-3 
compression 

blanks, specifying 2-6 
definition W-3 
condition, definition W-3 
configuration 

asynchronous/X.25 communications 11-3 
definition W-3 
prompting f acilities 11-10 
configuration displays 

blank fields (underscores) 11-10 
default values 11-10 
explanation of 11-10 
introduction 11-9 
line member displays 11-11 
sample values 11-10 
sequence diagram 11-9 
configuration member 
definition W-3 
type, SNA 3-8 
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configuration member name 

line member definition 11-11 
X.25 3-11 

configure, definition W-3 
configuring 

Display Station Pass-Through G-1 
for X.25 support 4-4 
SHM H-1 

configuring an X.25 network, introduction 11-18 
CONFIRM 
chart F-3 
verb F-3 

CONFIRMED, APPC verb F-3 
considerations, X.21 SHM H-4 
constant, definition W-3 
continuous carrier, defining using SETCOMM 
procedure 2-1 

control station, definition W-4 
control storage, definition W-4 
conversation 

building F-1 
ending F-4 

create new line member from existing 
BSC 3-21 
display (1.0) 11-11 

SNA 3-7 
creating 

connection list using DEFINX21 procedure 5-8 
connection list using DEFINX25 procedure 5-14 
phone list 

using DEFINEPN procedure 5-5 
using DEFINX21 procedure 5-8 
using DEFINX25 procedure 5-14 
creating a connection list display 5-10 
creating a line member 
BSC 3-21 
display (1.0) 11-11 

SNA 3-6 

creating line member from existing 11-11 
CRTLIND command for APPC B-11 
current library 
BSC 3-20 
definition W-4 
SNA 3-6 

cursor, definition W-4 


D 


data area, definition W-4 

data circuit-terminating equipment, definition W-4 
data clock (CLOCKING parameter) for APPC B-2 
data communications, definition W-4 
Data Encryption Subroutine, definition W-4 
data files, sending and receiving in file transfer 
subroutines 12-1 

data flow rate (VPACING parameter) for APPC B-4 
data link escape (DLE) character, definition W-4 
data link protocol, SNA 3-10 


data link, definition W-4 
data management, definition W-4 
data mode, definition W-4 
data rate, APPC SPEED parameter B-4, B-5 
data size (MAXDATA parameter) for APPC B-3 
data stream, definition W-4 
data terminal equipment, definition W-4 
data transmission method (NRZI parameter) for 
APPC B-3 
DCE 

See data circuit-terminating equipment 
DDFF 

See Distributed Disk File Facility 
DDM 

See Distributed Data Management 
DDM session group 
activating 10-1 
closing 10-3 
handling 10-3 
starting 10-1 
DEALLOCATE 
chart F-4 
verb F-4 

debug procedure, displayed and printed output 7-3 
debugging, communications subsystems using ICFDEBUG 
procedure 7-1 
default values 

configuration displays 11-10 
definition W-4 
default, definition W-4 
DEFINEID 
display 5-2 
example 5-3 
how called 5-2 
procedure paramters 5-2 
specifying remote ID 5-2 
DEFINEID entry display 5-3 
DEFINEID procedure 
explanation 5-1 
syntax diagram D-2 
DEFINEPN 

examples 5-6 
phone list display 5-6 
DEFINEPN procedure 
explanation 5-5 
phone list name 3-28 
syntax diagram D-2 

DEFINEX25 procedure, defining a phone list for 
X.25 4-2 
defining 

asynchronous subsystem member 11-5 
System/36 communications 3-1 
System/36 line members 3-1 
X.25 phone list 4-2 
defining the remote system 
BSC 3-27,3-28 
SNA 3-14 
defining the switch type 
BSC 3-26 
SNA 3-12 
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defining the switch type for BSC 3-26 
DEFINLOC procedure 

defining remote systems 11-4 
display 11-20 
syntax diagram D-3 
DEFINX21 

attempts to call a number 5-11 
calling a number 5-11 
deleting a phone number 5-10 
example 5-11 
examples 5-9 

inserting a phone number 5-10 
parameters 5-10 
wait time before retrying call 5-11 
DEFINX21 Connection List display 5-10 
DEFINX21 procedure 
explanation 5-8 
phone list name 3-28 
SHM H-1 
syntax diagram D-3 

DEFINX21 SHM Line Configuration display 5-12 
DEFINX25 Phone List Member Display, 
parameters 5-16 
DEFINX25 procedure 
display 5-14 
explanation 5-14 
parameters 5-14 
syntax diagram D-3 
delete a line member 
BSC 3-21 
SNA 3-7 

delete, definition W-4 
deleting a line member 11-12 
demodulate, definition W-4 
determining BSC error retry count 3-25 
devices on SHM line, rules for H-2 
DFHPCT macroinstruction (CICS VS) definition for 
APPC B-8 

DFHPPT macroinstruction (CICS VS) definition for 
APPC B-9 

DFHTCT macroinstruction (CICS VS) definition for 
APPC B-7 
DHCF 

See Distributed Host Command Facility 
DIAL parameter (GROUP macroinstruction) for 
APPC B-2 
DISABLE procedure 
examples 6-4 
introduction 6-3 
parameters 6-4 
syntax diagram D-3 
DISABLE procedure display 6-4 
disable, definition W-4 
disclosure, definition W-4 
DISCNT parameter, GROUP macroinstruction for 
APPC B-2 

disconnecting SNA 3-17 

disconnection, physical unit (DISCNT parameter) for 
APPC B-2 

disk data management, definition W-4 
display format, definition W-4 


Display Station Pass-Through 
CANCEL command G-7 
canceling G-7 
configuring G-1 
console mode G-3 
definition W-4 
error handling G-6 
features on remote system G-5 
introduction G-1 
OFF command G-7 
OFF HOLD command G-7 
operational differences G-3 
removing G-7 
sessions G-2 
signing off G-7 
subconsole mode G-3 
VARY OFF command G-7 
work station ID G-2 

Display Station Pass-Through Inquiry Options 
display G-3 

extended (EXTN) aids G-4 
messages G-4, G-5 
options G-3, G-4 

Display Station Pass-Through session group 
activating 10-1 
closing 10-3 
handling 10-3 
starting 10-1 

display station, definition W-4 

displays 

ALTERCOM 2-8 
APPC 

APPC Location Definition (41.0) 9-11 

APPC Session Group Additional Options 
(44.0) 9-16 

APPC Session Group Definition (43.0) 9-14 

Remote Location Definition (30.0) 9-10 

Remote Location Selection (29.0) 9-8 

Session Group Selection (42.0) 9-12 

SNA Configuration Member Type (4.0) 9-5 

SNA Subsystem Member Selection (21.0) 9-6 

SSP-ICF Configuration Member Definition 
(1.0) 9-3 

SSP-ICF Configuration Member Type (2.0) 9-4 
Subsystem Member Definition (22.0) 9-7 

Async Configuration Member Type 11-13 
Async Line Member Attributes 11-14, 11-15 
asynchronous communications subsystem 
configuration 11-12 

BSC Configuration Member Type (3.0) 3-24 

BSC Line Member Attributes 00.0) 3-25 

DEFINEID 5-2 

DEFINEID entry 5-3 

DEFINEPN phone list display 5-6 

definition W-4 

DEFINLOC procedure 11 -20 

DEFINX21 Connection List 5-10 

DEFINX21 SHM Line Configuration 5-12 

DEFINX25 5-14 

DISABLE procedure 6-4 

Display Station Pass-Through Inquiry Options G-3 
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ENABLE procedure 6-1 

flow of X.25 configuration utility 4-12 

ICFDEBUG 7-2 

PASSTHRU G-1 

Remote Location Definition (1.0) 11 -20 

Remote System Attributes (11.0) 3-28 

Remote System Attributes (13.0) 3-15 

Remote System Logical Unit Assignments 
(14.0) 3-18 

Remote System Selection (10.5) 3-27 

Remote System Selection (12.5) 3-14, 11-17 
REQUESTX procedure prompt display 8-2 
SETCOMM 2-2 

SNA Line Member Attributes (12.0) 3-10, 3-11 

SSP-ICF Configuration Member Definition (10) 

BSC 3-20,3-22 
SNA 3-6,3-7 

SSP-ICF CONFIGURATION MEMBER 
DEFINITION display for asynchronous 
communications 11-11 

SSP-ICF Configuration Member Type (1.0) 11-12 

SSP-ICF Configuration Member Type (2.0) 

BSC 3-23 
SNA 3-8 

SSP-ICF Configuration Member Type (4.0) 3-9 
STARTM 7-4 
STATEST 7-6 

STOPGRP procedure command 10-3 
STOPM 7-12 

STRTGRP procedure command 10-1 
X.25 Active Virtual Circuit Configuration Members 
(4.0) 4-31 

X.25 Call Wait Queue Status (3.0) 4-29 
X.25 Configuration Utility Menu 4-13 
X.25 Configuration Utility Menu (1.5) 4-14 

X.25 Define Phone List 5-17 
X.25 Define Phone List Menu 5-15 
X.25 Logical Channel Configuration (3.0) 4-15 

X.25 Logical Channel Status (2.0) 4-27 
X.25 Maintenance Utility Menu (1.0) 4-26 

X.25 Network Configuration (2.0) 4-15 

X.25 Permanent Virtual Circuit Configuration 
(7.0) 4-21 

X.25 Permanent Virtual Circuit Modification 
(7.0) 4-36 

X.25 Phone List Member Selection 5-16 
X.25 Switched Virtual Circuit Configuration 
(8.0) 4-22 

X.25 Switched Virtual Circuit Modification 
(8.0) 4-37 

X.25 Virtual Circuit Configuration (6.0) 4-19 

X.25 Virtual Circuit Configuration Status (5.0) 4-32 
X.25 Virtual Circuit Configurations with Tariff Totals 
(9.0) 4-40 

X.25 Virtual Circuit Member Select (5.0) 4-18 

X.25 Virtual Circuit Menu (4.0) 4-17 
X.25 Virtual Circuit Modification (6.0) 4-34 

X.25 Virtual Circuit Totals (10.0) 4-41 
DisplayWrite/36 
See also DW/36 
definition W-5 


Distributed Data Management, definition W-5 
Distributed Disk File Facility, definition W-5 
Distributed Host Command Facility, definition W-5 
Distributed Systems Executive, definition W-5 
Distributed Systems Node Executive, definition W-5 
DLE 

See data link escape character 
DSNX 

See Distributed Systems Node Executive 
DSPT 

See Display Station Pass-Through 
DSX 

See Distributed Systems Executive 
DTE 

See data terminal equipment 
duplex 

definition W-5 

line attributes (display 12.1) 11-15 

DUPLEX parameter, GROUP macroinstruction for 
APPC B-3 
DW/36 

See DisplayWrite/36 


E 


EBCDIC 

See extended binary-coded decimal interchange code 
EBCDIC character, definition W-5 
EBCDIC characters for addressing and polling 2-13 
EBCDIC characters, for addressing and polling 2-13 
eight-line communications adapter/attachment, 
definition W-5 
ELCA 

See also eight-line communications 
adapter/attachment 
X.25 4-2 

5360 System Unit 4-2 
5362 System Unit 4-2 
emulation, definition W-5 
ENABLE procedure 
examples 6-2 
introduction 6-1 
parameters 6-2 
syntax diagram D-4 

ENABLE procedure command, switch type 3-12, 3-26 

ENABLE procedure display 6-1 

enable, definition W-5 

enabling, Intra subsystem 6-2 

end of number characters, autocall, allowing 2-1 

ending 

asynchronous communications sessions using 
DISABLE procedure 6-3 
MSRJE sessions using DISABLE procedure 6-3 
SSP-ICF sessions using DISABLE procedure 6-3 
3270 device emulation sessions using DISABLE 
procedure 6-3 

Enhanced recovery logical link control (ELLC) 4-20 
enter, definition W-5 
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ERAP, definition W-5 
error 

retry count, changing 

using ALTERCOM procedure 2-6 
using SETCOMM procedure 2-1 
wait time, changing 

using ALTERCOM procedure 2-6 
using SETCOMM procedure 2-1 
error code, definition W-5 
error handling. Display Station Pass-Through G-6 
error recording analysis procedure, definition W-5 
Error Recovery Analysis Procedure (ERAP), X.21 
SHM H-4 

error retries, RETRIES parameter for APPC B-4 

error retry count, BSC 3-25 

EVOKE procedure C-2 

evoke, definition W-5 

examples 

ALTERCOM 2-11 

assigning station addresses 11-4 

data file qualifiers for file transfer subroutines 12-6 

DEFINEID 5-3 

DEFINEPN 5-6 

defining an X.21 connection list 5-9 
DEFINX21 5-9,5-11 
DISABLE procedure 6-4 
ENABLE procedure 6-2 
ICFDEBUG 7-2 

library memeber qualifiers for file transfer 
subroutines 12-7 
phone list creation 5-6 
relationship with an SSP-ICF subsystem 4-6 
relationship with remote work stations 4-6 
REQUESTX procedure 8-3 
SETCOMM 2-5 

single switched line to an SVC 4-10 
STARTM 7-5 

steps for configuring X.25 4-4 

STOPGRP 10-3 
STOPM 7-12 
STRTGRP 10-2 

typical logical channel configuration 4-8 
exchange ID, SDLC (IDBLK, IDNUM parameters) for 
APPC B-6 

exchange identifier (EXCHID parameter) for 
APPC B-12 

exchange identifier, System/36 SNA 3-13 
EXCHID parameter (CRTLIND command) for 
APPC B-11 

EXCHID parameter for APPC B-12 
expression, definition W-5 
extended (EXTN) aids. Display Station 
Pass-Through G-4 

extended binary-coded decimal interchange code, 
definition W-5 


external clocking (CLOCKING parameter) for 
APPC B-2 


F 


feature, definition W-5 
field, definition W-5 
file name, definition W-6 
file transfer subroutines 
description 12-1 
example of assembler 12-3 
examples of qualifiers for data files 12-6 
examples of qualifiers for library members 12-7 
introduction 11-1 
messages 12-9 
parameter list 12-5 
qualifiers 12-5 
record length used by 12-1 
restrictions 12-1 
SUBRFl for assembler 12-2 
SUBRFl for COBOL 12-4 
SUBRF2 for RPG II 12-4 
subsystems using 12-1 
file, definition W-6 

finance controllers, testing using STALEST 
procedure 7-5 

first-level message, definition W-6 

flow rate, VPACING parameter for APPC B-4 

FLUSH, APPC verb F-5 

folder, definition W-6 

format, definition W-6 

frame transmission 

APPC MAXOUT parameter B-3 
APPC PASSLIM parameter B-4 

FTS 

See file transfer subroutines 
full duplex, definition W-6 
function key, definition W-6 
function management header, definition W-6 


G 


generation considerations 

APPC ACF NCP VTAM B-1 
APPC CICS VS B-7 
generation, definition W-6 
generic remote systems 11-4 
GET_ATTRIBUTES, APPC verb F-5 
GET_TYPE and GET_ATTRIBUTES, chart F-5 
GET_TYPE, APPC verb F-5 
GROUP macroinstruction (NCP VTAM) definition for 
APPC B-2 
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H 


half-duplex mode communications (DUPLEX parameter) 
for APPC B-3 
half duplex, definition W-6 
handling 

APPC session group 10-3 

DDM session group 10-3 

Display Station Pass-Through session group 10-3 

PS/36 document distibution function 10-3 
handling errors, Display Station Pass-Through G-6 
HCF 

See Host Command Facility 
HDLC 

See high-level data link control 
Help key, definition W-6 
help text, definition W-6 
hex 

See hexadecimal 
hexadecimal, definition W-6 
high-level data link control, definition W-6 
Host Command Facility, definition W-6 
host-provided clocking (CLOCKING parameter) for 
APPC B-2 

host system, definition W-6 


I 


IBM PC, definition W-6 
ICFDEBUG 
display 7-2 
example 7-2 
parameters 7-2 
ICFDEBUG procedure 
display 7-1 
syntax diagram D-4 
ID, changing remote 2-6 

IDBLK parameter (PU macroinstruction) for APPC B-6 
identifier(s) 

APPC local system B-12 
APPC remote system B-12 
identifier, definition W-6 
IDNUM parameter (PU macroinstruction) for 
APPC B-6 

IF expressions, definition W-6 
IGS 

See interchange group separator 
informational message, definition W-6 
initial connection call failure, X.21 SHM H-3 
initial program load, definition W-6 
initialize, definition W-6 
inquiry, definition W-6 
interactive applications 
remote system G-1 
SHM H-1 

Interactive Communications Feature, definition W-7 


interactive processing, definition W-7 
interactive terminal facility 
introduction 11-1 
sending memos 11-1 
interactive, definition W-6 
interchange group separator, definition W-7 
intermediate block check, definition W-7 
intermediate-text-block (ITB) character, definition W-7 
internal clocking (CLOCKING parameter) for 
APPC B-2 
Intra subsystem 
definition W-7 
enabling 6-2 
introduction 

asynchronous communications subsystem 11-1 
Display Station Pass-Through G-1 
file transfer subroutines 11-1 
interactive terminal facility 11-1 
multiple X.25 lines 11-2 
X.21 short hold mode H-1 
invite, definition W-7 
IPL 

See initial program load 
ISTATUS parameter 

GROUP macroinstruction for APPC B-3 
LINE macroinstruction for APPC B-5 
ITB 

See intermediate block check 
ITF 

See interactive terminal facility 


0 

job step, definition W-7 
job, definition W-7 


K 


K-byte, definition W-7 
key, definition W-7 


0 

label, definition W-7 
left-adjust, definition W-7 
library member subtype, definition W-7 
library members 
definition W-7 

sending and receiving, file transfer subroutines 12-1 
library name, line member definition 11-11 
library used for line member 
BSC 3-20 
SNA 3-6 
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library, definition W-7 
licensed program, definition W-7 
line activation (ISTATUS parameter) for APPC B-5 
line address, local (ADDRESS parameter) for 
APPC B-4 
line attributes 
duplex 11-15 
line rate 11-14 
local echo 11-15 
local XON/XOFF 11-15 
modem initialization 11-16 
number of retries 11-14 
number of stop bits 11-14 
total number of remote systems 11-16 
type of parity 11-14 
wait time for acknowledgment 11-14 
X.25 configuration member name 11-16 
line characteristics 
BSC 3-25 

defined in line member 3-1 
line configurations 
changing 4-25 
defining SHM 5-11 

line connection type (CNN parameter)for APPC B-10 
line control (LNCTL parameter) for APPC B-2 
LINE macroinstruction (NCP VTAM) definition for 
APPC B-4 
line member 

changing 11-11 
configuration displays for 11-11 
configured before subsystem member 11-9 
creating 11-11 
creating from existing 11-11 
deleting 11-12 
modifying its attributes 11-9 
reviewing 11-12 
shared by subsystems 11-9 
line member definition 
BSC 3-20 
SNA 3-4 
line members 
BSC 

changing 3-21 
creating 3-6,3-21 
creating form existing 3-21 
defining 3-2 
deleting 3-21 
naming 3-20 
reviewing 3-21 
defining nonswitched lines 3-3 
defining primary multipoint nonswitched lines 3-3 
defining switched lines 3-3 
line characteristics 3-1 
nonswitched 3-1 
remote characteristics 3-2 
SNA 

changing 3-6 
creating from existing 3-7 
definition example 3-4 
deleting 3-7 

existing member library 3-7 


existing name 3-7 
naming 3-6 
reviewing 3-7 
types 3-2 

SNA attributes 3-10, 3-11 
SNA/SDLC 3-2 
SNA/X.25 3-2 
switched 3-1 
X.25 line type 3-11 

line rate, line attributes (display 12.0) 11-14 

line setting changes 2-2, 2-8 
line speed 

APPC GROUP macroinstruction (SPEED 
parameter) B-4 
APPC SPEED parameter B-4 
defining communications using SETCOMM 
procedure 2-1 
line type 

APPC (TYPE parameter) B-10 

BSC 3-25 

SNA 

nonswitched 3-11 
on display 12.0 3-10 
switched 3-11 

line type definition (DIAL parameter) for APPC B-2 
line, communications 

defining using ALTERCOM procedure 2-6 
defining using SETCOMM procedure 2-1 
link disconnection (DISCNT parameter) for APPC B-2 
link level, definition W-7 
link protocol, definition W-7 
LNCTL parameter (GROUP macroinstruction) for 
APPC B-2 

load member, definition W-7 
load, definition W-7 

LOCADDR parameter (LU macroinstruction) for 
APPC B-6 

local echo supported, line attributes (display 12.1) 11-15 

local ID, changing 2-6 

local line address (ADDRESS parameter) for APPC B-4 
local session address (LOCADDR parameter) for 
APPC B-6 

local station address, SNA 3-15 
local station switched line ID, specifying using 
ALTERCOM procedure 2-6 
local XON/XOFF supported, line attributes (display 
12.1) 11-15 

local, definition W-7 
location name, definition W-7 

location profiles C-1 r 

log, definition W-7 

logical channel configuration, defining A-1 
logical channel, definition W-7 
logical channels 

connection to virtual circuits 4-8 
logical channels/maximum number for Sysiem/36 4-7 
Logical Link Control (QLLC) 4-20 
logical record delimitation, APPC LOGREC 
parameter B-8 
logical unit 

APPC defining (LU macroinstruction) B-5 
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APPC number (LOCADDR parameter) B-6 
APPC type (DEVTYPE parameter) B-12 
definition W-8 

name, APPC NETNAME parameter B-8 
number of on remote system 3-18 
restrictions on using 3-19 
logical unit assignment 3-18 
LOGREC parameter (DFHPCT macroinstruction) for 
APPC B-8 
LU 

See logical unit 

LU macroinstruction (NCP VTAM) definition for 
APPC B-5 
LU6.2 verbs 

ALLOCATE F-1 
basic conversations F-1 
CONFIRM F-3 
CONFIRMED F-3 
DEALLOCATE F-4 
FLUSH F-5 

GET__ATTRIBUTES F-5 
GET_TYPE F-5 
POST_ON_RECEIPT F-6 
PREPARE_TO_RECEIVE F-7 
RECEIVE_AND_WAIT F-9 
REQUEST_TO_SEND F-9 
SEND_DATA F-10 
SEND_ERROR F-10 
using F-1 
WAIT F-11 


M 


macro 

See macroinstruction 
macroinstructions 

APPC GROUP B-2 
APPC LINE B-4 
APPC LU B-5 
APPC SERVICE B-5 
definition W-8 
DFHPCT B-8 
DFHPPT B-9 
DFHTCT B-7 
main storage, definition W-8 

MAINTX25, displaying information about X.25 link 4-2 
manual answer 

ALTERCOM 2-8 
definition W-8 
switch type 3-17 
manual call 

ALTERCOM 2-8 
definition W-8 

master configuration record, definition W-8 
MAXCNV parameter for APPC B-13 
MAXDATA parameter, GROUP macroinstruction for 
APPC B-3 


Maximum number of conversations (MAXCNV 
parameter) for APPC B-13 
Maximum number of source sessions (MAXSRCSSN 
parameter) for APPC B-13 
MAXOUT parameter, GROUP macroinstruction for 
APPC B-3 

member library names, existing BSC 3-22 
member names, existing BSC 3-22 
member, definition W-8 
menus 

definition W-8 

X.25 Active Virtual Circuit Configuration Members 
(4.0) 4-31 

X.25 Call Wait Queue Status (3.0) 4-29 
X.25 Configuration Utility 4-13 
X.25 Configuration Utility (1.5) 4-14 

X.25 Logical Channel Configuration (3.0) 4-15 
X.25 Logical Channel Status (2.0) 4-27 
X.25 Maintenance Utility Menu (1.0) 4-26 

X.25 Network Configuration (2.0) 4-15 

X.25 Permanent Virtual Circuit Configuration 
(7.0) 4-21 

X.25 Permanent Virtual Circuit Modification 
(7.0) 4-36 

X.25 Switched Virtual Circuit Configuration 
(8.0) 4-22 

X.25 Switched Virtual Circuit Modification 
(8.0) 4-37 

X.25 Virtual Circuit Configuration (6.0) 4-19 
X.25 Virtual Circuit Configuration Status (5.0) 4-32 
X.25 Virtual Circuit Configurations with Tariff Totals 
(9.0) 4-40 

X.25 Virtual Circuit Member Select (5.0) 4-18 
X.25 Virtual Circuit Menu (4.0) 4-17 

X.25 Virtual Circuit Modification (6.0) 4-34 
X.25 Virtual Circuit Totals (10.0) 4-41 

message identification code, definition W-8 
message identification, definition W-8 
message type(s), APPC SSCPFM parameter B-4 
messages 

definition W-8 

Display Station Pass-Through G-4, G-5 
file transfer subroutine 12-9 
MIC 

See message identification code 
minimum line speed (SPEED parameter) for APPC B-4 
MLCA 

See also multiline communications 
adapter/attachment 
X.25 4-2 

mode entry name (MODE parameter), APPC 
ADDDEVMODE command B-13 
mode, definition W-8 
modem clocking 

changing using ALTERCOM procedure 2-6 
defining using SETCOMM procedure 2-1 
modem data clock (CLOCKING parameter) for 
APPC B-2 

modem initialization, line attributes (display 12.1) 11-16 

modem, definition W-8 
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modulation, definition W-8 
modulator-demodulator 
j See modem 
module, definition W-8 
monitor, definition W-8 
MRT 

See multiple requester terminal procedure 
MRT program 

See multiple requester terminal (MRT) program 
MSRJE 

See Multiple Session Remote Job Entry 
multiline communications adapter/attachment, 
definition W-8 

multiple communications files, allowing 2-6 
multiple requester terminal (MRT) procedure, 
definition W-8 

multiple requester terminal (MRT) program, 
definition W-8 

Multiple Session Remote Job Entry, definition W-8 
multiple X.25 lines 11-2 
multipoint communications line 2-9 
multipoint line, service order (SERVICE 
macroinstruction) for APPC B-5 
multipoint, definition W-8 


N 


name of existing remote system, BSC 3-28 
name of remote system, BSC 3-28 
naming the line member 
BSC 3-20 
SNA 3-6 

NCP network control (TYPE parameter) for APPC B-4 
NCP VTAM generation considerations for APPC B-1 
negative response, definition W-8 
NEP 

See never-ending program 

NETNAME parameter (DFHTCT macroinstruction) for 
APPC B-8 

network addresses, creating using DEFINX25 
procedure 5-14 

network configuration, defining A-1 
network control (USE parameter) for APPC B-4 
network control type (TYPE parameter) for APPC B-4 
network facilites, X.21 SHM H-4 
network type 
A A-1 

AUSTPAC A-1 
B A-1 

by country A-1 
C A-1 
D A-1 

DATAPAK A-1 
DCS A-1 
DDX-P A-1 


ISRANET A-1 
ITAPAC A-1 
SWITCHSTREAM 1 A-1 

TELENET A-1 
TELEPAC A-1 
network, definition W-9 
never-ending program, definition W-9 
nodes 

definition W-9 
XID for short hold mode H-2 
non-return-to-zero inverted, definition W-9 
nonswitched communications lines 2-8 
nonswitched line 

APPC NCP VTAM generation B-2 
defining (DIAL parameter) for APPC B-2 
nonswitched line, definition W-9 
nonswitched point-to-point line 3-11, 3-25 
NRZI 

See also non-return-to-zero inverted 
data transmission (NRZI parameter) for APPC B-3 
defining using SETCOMM procedure 2-3 
parameter (GROUP macroinstruction) for 
APPC B-3 

NRZI parameter (GROUP macroinstruction) for 
APPC B-3 

null character, definition W-9 

null record, definition W-9 

number of logical units, remote systems 3-18 

number of retries, line attributes (display 12.0) 11-14 

number of stop bits, line attributes (display 12.0) 11-14 


o 


OCL 

See operation control language 
OFF command. Display Station Pass-Through G-7 
OFF HOLD command, Display Station 
Pass-Through G-7 
operation code, definition W-9 
operation control language, definition W-9 
operation, definition W-9 
operational differences. Display Station 
Pass-Through G-3 
options 

Async Configuration Member Type display 11-13 

Async Line Member Attributes display 11-14, 

11-15 

Remote Location Definition display 11 -20 

SSP-ICF Configuration Member Type display 11-12 
ORDER parameter (SERVICE macroinstruction) for 
APPC B-5 
output, definition W-9 
overriding BSC parameters using ALTERCOM 
procedure 2-6 
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p 


packet switching data network, definition W-9 
packet switching, definition W-9 
packet window, definition W-9 
parameter list, file transfer subroutines 12-5 
parameters 
APPC 

APPC Location Definition (41.0) 9-11 

APPC Session Group Additional Options 
(44.0) 9-16 

APPC Session Group Definition (43.0) 9-14 

Remote Location Definition (30.0) 9-10 

Remote Location Selection (29.0) 9-8 

Session Group Selection (42.0) 9-12 

SNA Configuration Member Type (4.0) 9-5 
SNA Subsystem Member Selection (21.0) 9-6 

SSP-ICF Configuration Member Definition 
(1.0) 9-3 

SSP-ICF Configuration Member Type (2.0) 9-4 

Subsystem Member Definition (22.0) 9-7 

Changing configuration parameters 4-25 
changing virtual circuit 4-10 
DEFINEID 5-2 
DEFINEID entry 5-4 
DEFINEPN phone list display 5-6, 5-7 
definition W-9 
DEFINX21 5-10 
DEFINX25 5-14 

DEFINX25 Phone List Member Display 5-16 
DISABLE procedure 6-4 
ENABLE procedure 6-2 
ICFDEBUG 7-2 
PASSTHRU G-1 

Remote System Selection display 11-17 

REQUESTX 8-2 

SETCOMM 2-2 

STARTM 7-4 

STALEST 7-6 

STOPGRP 10-3 

STOPM 7-12 

X. 21 SHM configuration 5-12 
X.25 Active Virtual Circuit Configuration 
Members 4-31 

X.25 Call Wait Queue Status 4-29 
X.25 Configuration Utility Menu 4-13, 4-14 
X.25 Define a Phone List display 5-17 
X.25 Logical Channel Configuration 4-16 
X.25 Logical Channel Status 4-27 
X.25 Network Configuration (2.0) 4-15 

X.25 Permanent Virtual Circuit Configuration 4-21 
X.25 Permanent Virtual Circuit Modification 4-36 
X.25 Switched Virtual Circuit Configuration 4-22 
X.25 Switched Virtual Circuit Modification 4-37 
X.25 Virtual Circuit Configuration Status 4-32 
X.25 Virtual Circuit Configurations with Tariff 
Totals 4-40 

X.25 Virtual Circuit Modification 4-34 
X.25 Virtual Circuit Totals 4-41 


parity type, line attributes (display 12.0) 11-14 

Pass-thru 

See Display Station Pass-Through 
PASSLIM parameter (GROUP macroinstruction) for 
APPC B-4 
PASSTHRU procedure 
display G-1 
parameters G-2 
remote location name G-2 
session group name G-2 
syntax diagram D-5 
password security, definition W-9 
passwords 

connection 4-23,4-38 
definition W-9 
security C-1 

PCT (program control table), CICS VS (DFHPCT 
macroinstruction) for APPC B-8 
peer considerations 

acquiring a peer session B-1 
APPC communications B-1 
Peer subsystem, definition W-9 
pending, definition W-9 
permanent virtual circuit, definition W-9 
Personal Services/36, definition W-9 
phone list creation, example 5-6 
phone list for autocall 
BSC 3-28 
SNA 3-17 
phone list, autocall 
BSC 3-28 
creating 3-17,3-28 
phone lists 

asynchronous communications phone lists 5-16 
changing using DEFINEPN procedure 5-5 
creating using DEFINEPN procedure 5-5 
creating using DEFINX21 procedure 5-8 
creating using DEFINX25 procedure 5-14 
defining X.25 4-2 
definition W-9 
member selection 5-16 
X.25 5-15 

phone number for autocall, SNA 3-17 
physical connection, definition W-9 
physical level (X.25), definition W-10 
physical record, definition W-10 
Physical Services Headers (PSH) 4-19 
physical unit (PU) 

activation APPC (ISTATUS parameter) B-3 
address APPC (ADDR parameter) B-5 
APPC disconnection (DISCNT parameter) B-2 
APPC service order B-5 

data capacity APPC (MAXDATA parameter) B-3 
defining APPC (PU macroinstruction) B-5 
polling APPC (POLLED parameter) B-4 
type 

LINE macroinstruction (APPC) B-5 
PUTYPE parameter APPC 
PUTYPE parameter (APPC) B-4 
physical unit (PU) macro, NCP VTAM 3-13 
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point-to-point line, definition W-10 
POLLED parameter (GROUP macroinstruction) for 
APPC B-4 

polling (POLLED parameter) for APPC B-4 
polling characters, BSC 2-13 
positional parameter, definition W-10 
POST_ON_RECEIPT 
chart F-6 
verb F-6 

PPT (processing program table) for APPC B-9 
pre-established sessions, APPC ADDDEVMODE 
command B-13 
PREPARE_TO_RECEIVE 
chart F-7 
verb F-7 

priority service, requesting for X.25 4-38 

procedure commands 
ALTERCOM D-1 
DEFINEID D-2 
DEFINEPN D-2 
definition W-10 
DEFINLOC D-3 
DEFINX21 D-3 
DEFINX25 D-3 
DISABLE D-3 
ENABLE D-4 
ICFDEBUG D-4 
PASSTHRU D-5, G-1 
REQUESTX D-5 
SETCOMM D-6 
STARTM D-6 
STALEST D-7 
STOPGRP D-7 
STOPM D-7 
STRTGRP D-8 

procedure member, definition W-10 
procedure start request, definition W-10 
procedures 

ALTERCOM 2-6 
ALTERCOM for SHM H-1 
CNFIGICF for SHM H-1 
CNFIGSSP for SHM H-1 
CNFIGX25 11-18 
debugging 7-1 
DEFINEID 5-1 
DEFINEPN 5-5 
definition W-10 
DEFINX21 5-8 
DEFINX21 forSHM H-1 
DEFINX25 5-14 
DISABLE 6-3 
ENABLE 6-1 
EVOKE C-2 
ICFDEBUG 7-1 
PASSTHRU G-1 
REQUESTX 8-1 
SECEDIT COMM C-1 
SETCOMM 2-1 
SETCOMM for SHM H-1 
STARTM 7-4 
STALEST 7-5 


STOPGRP 10-3 
STOPM 7-12 
STRTGRP 10-1 

processing program table (PPT) for APPC B-9 
program control table, APPC CICS VS (DFHPCT 
macroinstruction) B-8 
program product, definition W-10 
program temporary fix, definition W-10 
program-to-program communications, SNA defined 
standard 9-1 
program, definition W-10 
programs and LUs interactions between F-1 
prompt display, REQUESTX procedure 8-2 
prompt, definition W-10 
prompting f acilities 11-10 
protocols 

definition W-10 

Enhanced error recovery logical link control 
(ELLC) 4-35 

Physical services headers (PSH) 4-35 
Q-bit logical link control (QLLC) 4-35 
PS/36 document distibution function 
activating 10-1 
closing 10-3 
handling 10-3 
starting 10-1 
PS/36, definition W-10 
PSDN 

See packet switching data network 
PSDN/describing asynchronous/X.25 
communications 11-3 
PTF 

See program temporary fix 
PU macro, NCP VTAM 3-13 
PU macroinstruction (NCP VTAM) definition, 
APPC B-5 

publications, System/36 xi 
PUTYPE parameter 

APPC GROUP macroinstruction B-4 
APPC LINE macroinstruction B-5 
PVC (permanent virtual circuits) 4-7 


Q 


qualifiers, file transfer subroutines 12-5 


R 


rate of flow, APPC VPACING parameter B-4 
receive data terminal (TERMSTAT parameter) for 
APPC B-8 

receive time-out, definition W-10 
receive unit size (BUFFER parameter) for APPC B-8 
RECEIVE_AND_WAIT 
chart F-9 
verb F-9 
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record separator 
changing 2-6 
definition W-10 

recovery procedure, definition W-10 
remote block ID, SNA 3-16 
remote characteristics, defined in line member 3-2 
remote IDs 

changing using ALTERCOM procedure 2-6 
defining using DEFINEID procedure 5-1 
remote location 

defined on display 1.0 11 -20 

listed by DEFINLOC procedure 11-20 
Remote Location Definition display (1.0) 11 -20 

remote station ID, SNA 3-16 
remote system 
attributes 

BSC 3-27 
SNA 3-14 

attributes defined on display 12.5 11-17 

LU assignment 3-18 
SNA, type 3-15 
type, SNA 3-15 
remote system attributes 
BSC 

defining 3-28 
ending definition 3-29 
remote system name 11-18 
Remote System attributes display 
BSC 3-28 
SNA 3-15 

remote system features. Display Station 
Pass-Through G-5 

Remote System Logical Unit Assignments (14.0) 
display 3-18 

remote system name, defining 3-14 
remote system name, remote system selection (display 
12.5) 11-18 

Remote System Selection display 
BSC 3-27 
SNA 3-14 

Remote System Selection display (12.5) 11-17 

remote systems 

defining with DEFINLOC 11 -4 
generic 11-4 

number of logical units 3-18 
running interactive applications G-1 
remote work stations 
See also RWS 

changing line configuration 4-25 

creating a list for 4-2 

defining 4-1 

defining X.25 4-7 

editing a list for 4-2 

linking to X.25 configuration 4-1 

overview for use with X.25 4-1 

printing a list for 4-2 

removing a list for 4-2 

requirements for X.25 4-1 

specifying the library 4-18 

specifying the name 4-18 

testing using STALEST procedure 7-5 


remotely started session, definition W-10 
remove a line member 

asynchronous communications 11-12 
BSC 3-21 
SNA 3-7 

removing the Display Station Pass-Through session G-7 
reports from the REQUESTX procedure 8-1 
request unit size (BUFFER parameter) for APPC B-8 
request unit, definition W-10 
REQUEST_TO_SEND, verb F-9 
requester, definition W-10 
requesting an X.21 facility using REQUESTX 
procedure 8-1 
REQUESTX procedure 

condition requirements 8-1 
ending 8-2 
examples 8-3 
introduction 8-1 
syntax diagram D-5 
verifying 8-2 

REQUESTX procedure prompt display 8-2 
REQUESTX, parameters 8-2 
REQX display format 8-3 
RESOURCE parameter for LU6.2 verbs F-1, F-5 
response unit, definition W-10 
restrictions 
FTS 

APPC 12-1 

asynchronous communications 12-1 
BSCEL 12-1 
Peer 12-1 
line member sharing 
APPC 3-4 
APPC secondary 3-4 
Finance 3-4 
Peer primary 3-4 
Peer secondary 3-4 
SNA MSRJE 3-4 
SNA subsystems 3-5 
SNA 3270 3-4 
SNA/SDLC 3-4 
SNA/X.25 3-5 
SNUF 3-4,3-5 

RETRIES parameter (GROUP macroinstruction) for 
APPC B-4 
retry count, error 

changing using ALTERCOM procedure 2-6 
defining using SETCOMM procedure 2-1 
return code, definition W-10 
reverse charging, definition W-10 
reverse-interrupt character, definition W-11 
reviewing a line member 

asynchronous communications 11-12 
BSC 3-21 
SNA 3-7 

RJPTERM JES3 statement, B subparameter 3-29 
RPG II file transfer subroutine, SUBRF2 12-4 
RU 

See response unit 

RU size (BUFFER parameter) for APPC B-8 
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RVI 

See reverse-interrupt character 
RWS 

See also remote work station 
Auto-Reconnect function, with X.21 SHM H-3 
definition W-11 


s 


sample values, configuration displays 11-10 
SCS character coded messages APPC (SSCPFM 
parameter) B-4 
SDLC 

See also synchronous data link control 
retry count, changing using ALTERCOM 
procedure 2-6 

retry count, defining using SETCOMM 
procedure 2-1 

testing remote work stations using STATEST 
procedure 7-5 

time-out value, changing using ALTERCOM 
procedure 2-6 

time-out value, defining using SETCOMM 
procedure 2-1 

SDLC (Synchronous Data Link Control) 

APPC line control (LNCTL parameter) B-2 
APPC response requirement (MAXOUT 
parameter) B-3 

APPC station address (STNADR parafeter) B-11 
APPC station address ADDR parameter B-5 
SECEDIT COMM procedure C-1 
secondary backup line, allowing 2-6 
secondary stations, APPC 9-1 
security 11-20 
APPC C-1 
ATTACH C-1 
BIND C-1 
chart for using C-3 
definition W-11 
from the APPC subsystem C-2 
from the application program C-2 
passwords C-1 
requirements for using C-3 
Session establishment C-1 
Transaction establishment C-2 
verifying C-1 
security for APPC C-1 
security officer, definition W-11 
select configuration member type 
BSC 3-23,3-24 
SNA 3-8,3-9 

selecting the operation,CNFIGICF BSC 3-21 
SEND_DATA 
chart F-10 
verb F-10 
SEND_ERROR 
chart F-10 
verb F-10 

sending data files, interactive terminal facility 11-1 


sending DW/36 documents, interactive terminal 
facility 11-1 

sending library members, interactive terminal 
facility 11-1 

sending memos, interactive terminal facility 11-1 
separator characters, autocall, allowing 2-1 
separator, record, changing 2-6 
sequence diagrams for configuration displays 11-9 
sequence of service, multipoint line (ORDER parameter) 
for APPC B-5 

SERVICE macroinstruction (NCP VTAM) definition for 
APPC B-5 

service order requirement (PASSLIM parameter) for 
APPC B-4 

service order, multipoint line APPC (SERVICE 
macroinstruction) B-5 

session address, APPC local (LOCADDR address) B-6 
session group, definition W-11 
session ID specification F-1 
sessions 

definition W-11 

Display Station Pass-Through G-2 
SETCOMM 
display 2-2 
examples 2-5 
parameters 2-2 
SETCOMM procedure 
introduction 2-1 
SHM H-1 
syntax diagram D-6 

setup, configuring an X.25 network (CNFIGX25) 11-18 
SEU 

See source entry utility 
SHM 

See short hold mode 
short hold mode 

See also X.21 short hold mode 
defining line configuration 5-11 
signing off. Display Station Pass-Through G-7 
single line communications adapter/attachment, 
definition W-11 

Single Port Sharing (SPS) and X.21 short hold 
mode H-1 

single requester terminal (SRT) program, 
definition W-11 
size, APPC RU B-14 
SLCA 

See also single line communications 
adapter/attachment 
asynchronous communications 11-2 
SNA 

See also systems network architecture 
autoanswer 

switch type 3-17 
automatic disconnect 3-17 
changing a line member 3-6 
CNFIGICF procedure, defining environment 3-4 
configuration member type 3-8 
creating a line member 3-6 
creating line member from existing 3-7 
data link protocol 3-1, 3-10 
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defining, remote system name 3-14 
deleting a line member 3-7 
existing member library name 3-7 
existing member name 3-7 
library for line member 3-6 
line member attributes 3-10, 3-11 
line member definition 3-2, 3-4 
line member definition example 3-4 
line member sharing restrictions 
APPC 3-4 
APPC secondary 3-4 
Finance 3-4 
Peer primary 3-4 
Peer secondary 3-4 
SNAMSRJE 3-4 
SNA subsystems 3-5 
SNA 3270 3-4 
SNA/SDLC 3-4 
SNA/X.25 3-5 
SNUF 3-4,3-5 
line type 3-10 

nonswitched 3-11 
switched 3-11 
local station address 3-15 
local system XID 3-13 
manual answer, switch type 3-17 
naming the line member 3-6 
phone list for autocall 3-17 
phone number for autocall 3-17 
remote block ID 3-16 
remote station ID 3-16 
remote system attributes 3-14 
remote system name 3-14 
remote system type 3-15 
reviewing a line member 3-7 
select configuration member type 3-8, 3-9 
specifying line type 3-10 
specifying logical units 3-18 
SSCP identification 3-17 
station address, local system 3-12 
switch type 3-17 
switch type definition 3-12 
switch type, session initiation 3-13 
system services control point ID 3-17 
types of System/36 communications line 
members 3-2 
XID 3-13 

SNA Line Member Attributes (12.0) display 3-10, 3-11 

SNA lu6.2 architecture 9-1 

SNA Upline Facility, definition W-11 

SNBU 

See switched network backup 
SNUF 

See SNA Upline Facility 
source entry utility, definition W-11 
source member, definition W-11 
specification entering using SEU or $MAINT utility 
program 8-3 
SPEED command 

APPC GROUP macroinstruction B-5 
APPC LINE macroinstruction B-5 


SRT program 

See single requester terminal program 
SSCPFM parameter, GROUP macroinstruction for 
APPC B-4 
SSCPID, SNA 3-17 
SSP 

See System Support Program Product 
SSP-ICF 

See also Interactive Communications Feature 

changing line configuration 4-25 

disabling subsystems 6-3 

enabling subsystems 6-1 

specifying the library 4-18 

specifying the name 4-18 

SSP-ICF Configuration Member Definition (1.0) display 
BSC 3-20,3-22 
SNA 3-6,3-7 

SSP-ICF CONFIGURATION MEMBER DEFINITION 
display for asynchronous communications 11-11 
SSP-ICF Configuration Member Type (2.0) display 
BSC 3-23 
SNA 3-8 

SSP-ICF Configuration Member Type (4.0) display 3-9 
SSP-ICF Configuration Member Type display 
(1.0) 11-12 

SSP-ICF line member, linking to X.25 configuration 4-1 
SSP-ICF subsystem, defining X.25 4-7 

standby line, allowing 2-6 

START command for RSCS BSC, B parameter 3-29 
start monitoring communications line using STARTM 
procedure 7-4 
starting 

all configured session groups 10-1 
APPC session group 10-1 
asynchronous communications sessions using 
ENABLE procedure 6-1 
DDM session group 10-1 
Display Station Pass-Through session group 10-1 
MSRJE sessions using ENABLE procedure 6-1 
one session group 10-1 
PS/36 document distibution function 10-1 
SSP-ICF sessions using ENABLE procedure 6-1 
3270 device emulation sessions using ENABLE 
procedure 6-1 

starting the CNFIGICF procedure 3-1 
STARTM 

display 7-4 
examples 7-5 
parameters 7-4 
STARTM procedure 
introduction 7-4 
syntax diagram D-6 

state, terminal (TERMSTAT parameter) for APPC B-8 
STATEST 

display 7-6 
parameters 7-6 
STATEST procedure 
introduction 7-5 
syntax diagram D-7 
station address 
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SDLC ADDR parameter for APPC B-5 
station addresses 
assigning 11-4 

changing using ALTERCOM procedure 2-6 
local SNA 3-15 
table of 2-13 

station ID, remote SNA 3-16 

station service order APPC (ORDER parameter) B-5 
stop monitoring communications line using STOPM 
procedure 7-12 
STOPGRP 

examples 10-3 
parameters 10-3 
procedure 10-3 

procedure command display 10-3 
procedure syntax diagram D-7 
STOPM 

display 7-12 
example 7-12 
parameters 7-12 
STOPM procedure 
introduction 7-12 
syntax diagram D-7 
STRTGRP 

examples 10-2 
parameters 10-1 
procedure 10-1 
procedure command 10-1 
procedure command display 10-1 
procedure syntax diagram D-8 
subconsole, definition W-12 
SUBRFl 

assembler file transfer subroutine 12-2 
assembler file transfer subroutine example 12-3 
assembler or COBOL file transfer subroutine 
parameter list 12-5 
qualifiers 12-5 
use in FTS 12-1 

COBOL file transfer subroutine 12-4 
SUBRF2 

RPG II file transfer subroutine 
coding example 12-4 
parameter list 12-5 
qualifiers 12-5 
use in FTS 12-1 
subroutine member 
definition W-12 
subroutine, definition W-12 
subsystem considerations for SHM line, remote work 
stations H-3 
subsystem member 

configured after line member 11-9 
defining 3-3 
subsystems 

debugging using ICFDEBUG procedure 7-1 
disabling using DISABLE procedure 6-3 
enabling using ENABLE procedure 6-1 
subsytem considerations for SHM line 
ICF-Peer subsystem H-3 
SNA Upline H-3 
SVC (switched virtual circuits) 4-7 


switch type 

answer 3-26 
autoanswer 3-12 
BSC 

autoanswer 3-26 
defining 3-26 
manual answer 3-26 
manual call 3-26 
inactive 3-12,3-26 
manual answer 3-12 
manual call 3-12 
SNA session initiation 3-13 
switch type, defining 
BSC 3-26 
SNA 3-12 

switched communications lines, specifying 
using ALTERCOM procedure 2-6 
using SETCOMM procedure 2-1 
switched line 

APPC NCP VTAM generation B-6 
defining APPC (DIAL parameter) B-2 
definition W-12 

switched network backup, definition W-12 
switched point-to-point line 3-11, 3-25 
switched virtual circuit, definition W-12 
synchronous data link control, definition W-12 
synchronous transmission, definition W-12 
synchronous, definition W-12 
syntax diagrams 

ALTERCOM D-1 
DEFINEID D-2 
DEFINEPN D-2 
DEFINLOC D-3 
DEFINX21 D-3 
DEFINX25 D-3 
DISABLE D-3 
ENABLE D-4 
ICFDEBUG D-4 
PASSTHRU D-5 
REQUESTX D-5 
SETCOMM D-6 
STARTM D-6 
STATEST D-7 
STOPGRP D-7 
STOPM D-7 
STRTGRP D-8 

system configuration, definition W-12 
system console, definition W-12 
system library, definition W-12 
system reference code, definition W-12 
system security, definition W-12 
system services control point ID, SNA 3-17 
System Support Program Product, definition W-12 
system unit, definition W-12 
System/36 communications 
line members 

asynchronous 3-3 
defining 3-1 
line characteristics 3-1 
remote characteristics 3-2 
subsystem member 3-3 
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systems network architecture, definition W-12 


T 


tariff information, X.25 4-11 

TERMID parameter F-1 
terminal control table, APPC CICS VS (DFHTCT 
macroinstruction) B-7 

terminal device specification (TYPE parameter) for 
APPC B-7 

terminal type specification (TRMTYPE parameter) for 
APPC B-7 

terminal, definition W-13 

TERMSTAT parameter (DFHTCT macroinstruction) for 
APPC B-8 
testing 

remote work stations using STATEST 
procedure 7-5 

throughput class, requesting for X.25 4-38 

time-out value, SDLC, defining 

using ALTERCOM procedure 2-6 
using SET COMM procedure 2-1 
tone, answer, defining using SETCOM procedure 2-1 
total number of remote systems, line attributes (display 
12.1) 11-16 

TPBFSIZ RES parameter, RTAM macro 3-29 
transaction, definition W-13 
transmit buffer length 3-29 
transmit data terminal (TERMSTAT parameter) for 
APPC B-8 

transparent data, definition W-13 
tributary address 
changing 2-6 
table of 2-13 

TRMTYPE parameter (DFHTCT macroinstruction) for 
APPC B-7 
type 

APPC control unit (TYPE parameter) B-11 
parity, line attributes (display 12.0) 11-14 

SNA remote system 3-15 
type of parity, line attributes (display 12.0) 11-14 

TYPE parameter 

APPC DFHTCT macroinstruction B-7 
GROUP macroinstruction, APPC B-4 


u 


unbind command, definition W-13 

underscores (_) on configuration displays 11-10 

UPSI 

See user program status indicator switch 
USE parameter (GROUP macroinstruction), APPC B-4 
user ID, definition W-13 


user program status indicator (UPSI) switch, 
definition W-13 
utilities, for SHM H-1 
utility programs 
$IDSET 5-2 
$IEDS 6-3 
$PNLM 5-5 


V 


VARY OFF command, Display Station 
Pass-Through G-7 

VBUILD macroinstruction (NCP VTAM) definition for 
APPC B-6 
viewing a line member 

asynchronous communications 11-12 
BSC 3-21 
SNA 3-7 
virtual circuit 

member name 4-18 
virtual circuit parameters, changing 4-10 
virtual circuit passwords 4-38 
virtual circuits 

configurations, status for call setup 4-29 
connection to logical channels 4-8 
defining 4-7 
definition W-13 

parameters, changing using display 6.0 4-34 
PVC (permanent virtual circuit) 4-7 
SVC (switched virtual circuit) 4-7 
volume table of contents, definition W-13 
VPACING parameter (GROUP macroinstruction) for 
APPC B-4 

VTAM (virtual telecommunications access method) 
generation considerations for APPC B-1 
messages (SSCPFM parameter) for APPC B-4 
VTOC 

See volume table of contents 


w 


WAIT 

chart F-11 
verb F-11 

wait time for acknowledgment, line attributes (display 
12.0) 11-14 

wait time, error, changing 

using ALTERCOM procedure 2-6 
using SETCOMM procedure 2-1 
work station ID, Display Station Pass-Through G-2 
work station, definition W-13 
workload balancing, X.21 SHM H-4 
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X 


X.21 connection list example 5-9 
X.21 feature, definition W-13 
X.21 public data network 

canceling a facility using REQUESTX 
procedure 8-1 

requesting a facility using REQUESTX 
procedure 8-1 
X.21 SHM 

See also short hold mode 
See also X.21 short hold mode 
configuration 5-11 
configuration parameters 5-12 
X.21 short hold mode 

See also short hold mode 
ALTERCOM procedure H-1 
call retry delays H-2 
changing X.21 SHM line H-1 
CNFIGICF procedure H-1 
CNFIGSSP procedure H-1 
communications costs H-1 
configuring H-1 

configuring for ICF-Peer or Upline H-1 
configuring RWS H-1 
defining X.21 SHM line H-1 
definition H-1, W-13 
DEFINX21 procedure H-1 
ERAP H-4 

initial connection call failure H-3 
interactive applications H-1 
international calls H-4 
international considerations H-4 
introduction H-1 

national/regional considerations H-4 
network facilities H-4 
rules for devices H-2 
SETCOMM procedure H-1 
setting configuration information H-1 
subsystem considerations 

remote work stations H-3 
RWS Auto-Reconnect H-3 
traffic determination H-4 
utilities for configuring H-1 
with Single Port Sharing (SPS) H-1 
workload balancing H-4 
XID node ID 

ICF-Peer or Upline H-2 
local system H-2 
remote 5294 H-2 
use of H-2 
X.21, definition W-13 
X.25 

as an interface 4-1 
call setup 4-29 

changing configuration parameters 4-25 
changing the virtual circuit parameters 4-10 
communications protocol 4-1 
components 4-1 


configuration member name 3-11 
configuring for 4-1, 4-4 
defining a phone list 4-2 
defining remote work stations or SSP-ICF 
subsystem 4-7 
defining virtual circuits 4-7 
definition W-13 
ELCA 4-2 

flow of configuration utility displays 4-12 

line type 3-11 

link level time-outs 4-15 

local network addresses 4-15 

logical channels, number of 4-15 

maintaining an X.25 link 4-2 

MLCA 4-2 

monitoring status 4-25 

network default packet sizing 4-15 

network default packet window 4-15 

network type specifying 4-15 

nonswitched lines 4-9 

packet size, maximum 4-15 

relationship with an SSP-ICF subsystem 4-6 

relationship with remote work stations 4-6 

remote systems supported 4-3 

single switched line to an SVC 4-10 

starting the X.25 configuration utility 4-11 

steps for configuring 4-4 

tariff information 4-11 

tarrif-related totals 4-40 

uses of 4-7 

when installed 4-7 

X.25 Active Virtual Circuit Configuration Members 
display 4-31 
parameters 4-31 
X.25 Call Wait Queue Status 
display 4-29 
parameters 4-29 

X.25 configuration member name, line attributes (display 
12.1) 11-16 

X.25 Configuration Utility Menu 
display 4-13 
parameters 4-13 

X.25 Configuration Utility Menu (1.5) 
display 4-14 
parameters 4-14 
X.25 Define a Phone List display 
parameters 5-17 

X.25 Define Phone List display 5-17 
X.25 Define Phone List Menu display 5-15 
X.25 feature, definition W-13 
X.25 Logical Channel Configuration 
display 4-15 
parameters 4-16 
X.25 Logical Channel Status 
display 4-27 
parameters 4-27 
X.25 Maintenance Utility Menu 
display 4-26 
parameters 4-26 
X.25 network 

configuration (CNFIGX25) 11-18 
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DEFINLOC utility 11-19 
maintenance (MAINTX25) 11-19 
settingup 11-18 

DEFINLOC 11-20 

specifying using SETCOMM procedure 2-1 
X.25 Network Configuration (2.0) 
displays 4-15 
parameters 4-15 

X.25 Network Configuration display, network type A-1 
X.25 Permanent Virtual Circuit Configuration 
display 4-21 
parameters 4-21 

X.25 Permanent Virtual Circuit Modification 
display 4-36 
parameters 4-36 

X.25 Phone List Member Selection display 5-16 
X.25 phone lists, using 5-15 
X.25 storage; requirements 4-2 
X.25 Switched Virtual Circuit Configuration 
display 4-22 
parameters 4-22 

X.25 Switched Virtual Circuit Modification 
display 4-37 
parameters 4-37 
X.25 utilities 

CNFIGX25 4-1 


DEFINEX25 4-2 
MA1NTX25 4-2 
X.25 Virtual Circuit Configuration 
display 4-19 
parameters 4-19 

X.25 Virtual Circuit Configuration Status 
display 4-32 
parameters 4-32 

X.25 Virtual Circuit Configurations with Tariff Totals 
display 4-40 
parameters 4-40 
X.25 Virtual Circuit Member Select 
display 4-18 
parameters 4-18 
X.25 Virtual Circuit Menu 
display 4-17 
parameters 4-17 
X.25 Virtual Circuit Modification 
display 4-34 
parameters 4-34 
X.25 Virtual Circuit Totals 
display 4-41 
parameters 4-41 
X.75, definition W-14 
XID node ID, for short hold mode H-2 
XID, SNA local system 3-13 
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